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PREFACE 


This manual describes the functions and features of the 
OS/32 COPY program, Part Number 03-215. 0OS/32 COPY allows 
users to copy, verify, and display data from disc files 

Or devices. 


User Prerequisites 


Users of OS/32 COPY should be familiar with the operation 
of OS/32 and MTM. Users who are working with labelled 
tapes must also be familiar with the TAPE LABELLER program, 
Part Number 03-149. 


- Synopsis of Chapters 


Chapter 1 provides a general overview of the program's cap- 
abilities. Chapter 2 explains loading and starting OS/32 
COPY, and mode of operation. Chapter 3 is intended for the 
new user and explains the fundamentals of copy, verify, and 
display operations. 


Chapter 4 provides complete information about the commands 
that are introduced in Chapter 3. Chapter 5 lists and ex- 
plains the messages produced by OS/32 COPY. 


Appendices provide: a summary of commands; information re- 
quired for establishing O0S/32 COPY as a task under 0OS/32; 

a table of device characteristics; tape label format infor- 
mation; TAPE LABELLER program information. 


Related Publications 


OS/32 Operator Reference Manual, Publication Number $29-574 

OS/32 Multi-Terminal-Monitor (MTM) Reference Manual, Publi- 
cation Number $29-591 

Perkin-Elmer 32-bit Sort/Merge Level II Reference Manual, 
Publication Number 29-615 


System Requirements 


OS/32 COPY executes as a user task under OS/32 MT4.1 or 
higher. 
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CHAPTER 1 
OS/32 COPY OVERVIEW 


1.1 GENERAL DESCRIPTION OF 0OS/32 COPY 


The OS/32 COPY program provides OS/32 users a comprehensive 
copy utility to use in an OS/32 or OS/32 MTM environment. 


OS/32 COPY supports: 
- media independent copy operations, providing data 
transfer between two files or devices of like or un- 


like characteristics. 


- a verify operation providing the user with the 
ability to guarantee the integrity of data copied. 


- standard IBM/ANSI magnetic tape labels, allowing 
either unblocked or blocked, labelled input or out- 
put tapes. 


- blocked or unblocked magnetic tapes without tape 
labels. 


- a basic set of commands which give the user the 
Capability to specify simple directives, 


e.g., COPY FILEA,FILEB 


where the program automatically allocates the output 
file with the appropriate characteristics. 


- an optional set of commands which provide added 
flexibility that allows the user to uniquely deter- 
mine the characteristics of the file being allocated, 


e.g., OUTPUT FILEB, file characteristics . 
COPY FILEA,FILEB 


OS/32 COPY also provides commands which allow: 
- portions of files to be copied 
- explicit allocation, renaming, and deletion of files 
- display of file data in hexadecimal format 


- explicit file positioning 
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CHAPTER 2 
GETTING STARTED 


This chapter discusses the steps required to make 0OS/32 COPY 
operational in your system: loading and starting the program 
are explained; interactive and batch operation are discussed. 


If you are using an MTM system, it is assumed that you are 
familiar with the SIGNON/SIGNOFF procedures required to use 
the system. 


2.1 LOADING OS/32 COPY 


To make OS/32 COPY operational, it must be established as a 
task prior to loading. Refer to Appendix B. Once estab- 
lished, it must be loaded from an external storage device 
(ex. disc, tape) into memory and can be subsequently started 
through the START command. In this discussion, assume that 
OS/32 COPY has been established as a task and is stored on 
disc under the filename COPY32.TSK. 


Following are examples showing how to load OS/32 COPY in an 
OS/32 and an MTM environment. In the examples, the "*", 
which is output by the system, indicates that the system is 
ready to accept a command from you, the user. 


OS/32 Environment: 


In the OS environment you enter the LOAD command 
Followed by the TASK command. The TASK command 

is required to set COPY32 as the currently sel- 

ected task. 


*LOAD COPY32,,seg-size increment 
*TASK COPY32 


In this example, both commas are required. The 


OS/32 Operator's Reference Manual describes the 
LOAD command in detail. 
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MTM Environment: 
Only the LOAD command is required. 
*LOAD COPY32,seg-size increment 


“seg-size increment" in the above examples is an optional | 

argument used to provide additional memory for COPY32 working 
space, thus generally improving response time of the program. 
Seg-size increment is a decimal integer argument which repre- 
sents the amount of memory in k-bytes to be used for the pro- 


gram's working space. 


The record length and block size of the files being copied 
should be considered when determining the seg-size incre- 
ment field. 


The seg-size increment should be greater than or equal to: 


2 * recmax +] 
1024 


where 


recmax = largest input record or output record or 
magnetic tape block size 


Example: Suppose you intend to copy a magnetic tape con- 
taining 126 byte records blocked 10 records, to a disc file. 
In this case: 


input record size = 1260 (i.e., block of 10 records, 
each 126 bytes long) 


cutput record size = 126 
then recmax = input record size = 1260 


2*recmax + 1 = 2*1260 + 1 = 3 
1024 1024 


The seg-size increment is 3, and the LOAD command would be: 


OS/732 (MT: *LOAD COPY32,,3 
or 
MTM: “LOAD COPY32,3 


When copying contiguous files, the minimum input or output 
buffer size is 256. However, copying proceeds more quickly 
if a large value for seg-size increment is specified. A 
value of 10 or 12 is recommended for optimal performance. 
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2.2 STARTING OS/32 COPY 


After OS/32 COPY has been loaded, the START command is used 
to begin execution of the program. The format of this com- 
mand is the same for both the OS/32 and MTM environments. 


The START command for OS/32 COPY has three optional argu- 
ments. The minimum acceptable abbreviations for each argu- 
ment are indicated by underlining. The format, in the 
Simplest case, is: 


START 


where defaults are used for the command, log and list de- 
vices as explained below. 


Alternatively, the user may override any of the defaults by 
explicitly specifying the associated command, log, and/or 
list device: 


START , COMMAND=fdl1,LOG=fd2,LIST=fd3 
Any or all of the arguments may be specified, in any order. 


When the simple form of the START command is used, OS/32 COPY 
automatically uses the device CON: (e.g., Model 1100, Car- 
ousel) as both the command and the list device. 


The console device (often called the terminal) is the device 
at which you enter commands to OS/32, MTM, or OS/32 COPY. 


If the use of the console device for both command input and 
for output 1S not appropriate for your needs, one of the 
alternate START forms can be used to specify a different 
device. 


2.2.1 Command Device: COMMAND=fdl 


The file descriptor fdl specifies the command input device. 
You enter commands to OS/32 COPY from the command input de- 
vice. If a command input device is not specified, commands 
are read from the console device, CON:. 
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2.2.2 Log Device: LOG=fd2 


The file descriptor fd2 specifies the device for recording 
commands and responses. This device is called the log de- 
vice or sometimes the command output device. If the log 
device is not specified, a default is used, as explained 
below. 


The log device also receives all messages and error indi- 
cations. The log device may be altered during program - 
execution by using the LOG command. Logging may be sus- 
pended by entering the NOLOG command. If a disc file is 
specified as the log device, the file must already exist. 


2.2.3 List Device: LIST=fd3 


The file descriptor fd3 specifies the output device to be 
used by the VERIFY and DISPLAY commands. If the LIST de- 
vice is not specified, a default is used, as explained 
below. The list device may be changed during program 
execution using the LIST command. If a disc file is spec- 
ified as the list device, the file must already exist. 


2.2.4 START Examples 


The following examples illustrate the START command defaults 
associated with the various START commands: 


Command List 
Command Device Device Log Device 
ST CON: CON : no logging enabled 
ST, LIST=PR: CON: PR: no logging enabled 
ST,C=TTY:,LO=PR1L: TTY: a As no logging enabled 
ST,C=FPILE.CMD FILE.CMD PR: PR: 


When the log and the list devices are the same, they share 
one logical unit, ensuring that displays are intermingled 
with the commands and messages in the order in which they 
occurred. 


The default device assignments are explained below in the 
section describing mode of program operation. 
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2.3 COMMUNICATING WITH OS/32 COPY 


Once 0S/32 COPY has been started with the START command, 
OS/32 COPY displays its program identification, followed 
by the greater than ( ) symbol. OS/32 COPY outputs the 

symbol whenever it expects you to enter a command: 


OS/32 COPY Rn 
> 


where, 


Rn is the revision number of the 0S/32 COPY program 
that you are using; 


> is the prompt character indicating that OS/32 COPY 
is ready to accept a command from the user. 


When you enter a command in response to the prompt charac- 
ter, COPY interprets the command and performs the specified 
Operation. When execution of the operation is completed, 
COPY outputs the prompt character again. 


2.3.1 Mode of Program Operation 


Commands to OS/32 COPY may be entered interactively or in 
batch mode. The mode is determined by the command device 
specified in the START command. If the command device is 
interactive, the program executes interactively; if the 
command device is non-interactive, or is a disc file, the 
program executes in batch mode. 


The information in this manual is directed toward the user 
who is operating the program interactively. When program 
operation differs between batch and interactive mode, these 
differences are cited within the specific descriptions. 


2.3.1.1 Interactive Mode 


In interactive mode, the user enters commands from an in- 
teractive device. Each command is terminated by depressing 
the RETURN key. In this case, the LIST device defaults to 
the COMMAND device, allowing all command responses and error 
messages to be output to the command input device. 


2.3.1.2 Batch Mode 


In batch mode, commands are input from a disc file ora 
non-interactive device. In this case, both LIST and LOG 
default to the device named PR:. All command input and 
all program messages are output to the LOG device. The 
LIST device is used for output produced by the DISPLAY and 
VERIFY commands. — 
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2.4 STOPPING OS/32 COPY 


2.4.1 Terminating the Program 

OS/32 COPY can be normally terminated by entering the command: 
END 

An abnormal termination of the program only occurs if invalid 

START arguments are encountered. 

2.4.2 Terminating a Command Operation 

Certain OS/32 COPY commands can be terminated before normal © 

completion using the 0S/32 SEND STOP command. When running 


as a task under OS/32, two commands are necessary: 


*TASK taskid 
*SEND STOP 


When running under MTM, cnly the SEND STOP command 1s required: 
*SEND STOP 


In interactive mode, the next command is read. If the next 
command entered is: 


CONTINUE 


the interrupted operation is resumed. If any other command 
is entered, the new command is processed. 


In batch mode, the SEND STOP has no effect. 


2.5 PAUSING THE PROGRAM 


You may cause program execution to pause by entering the 
command: 


PAUSE 


You may now enter OS/32 or MTM commands. Execution of 
COPY may be resumed by entering: 


*CONTINUE 
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CHAPTER 3 
GUIDE TO OS/32 COPY FEATURES 


3.1 INTRODUCTION 

This chapter illustrates the features available to you as a 
user of OS/32 COPY and gives examples of the most commonly 
used operations. The examples assume you have loaded and 
started OS/32 COPY as described in Chapter 2. 

3.1.1 Overview of 0S/32 COPY Commands 


e The basic data transfer operations are accom- 


plished by: 
COPY Copies files and/or records 
DISPLAY To display data 
VERIFY Compares files and/or records 


e The basic COPY or VERIFY operations can be 
modified using: 


OPTIONS operands control writing file- 
mark, binary format, etc. 


@e Files can be explicitly described for use by 
COPY, DISPLAY, or VERIFY using: 


INPUT Operands give blocking factor, 
OUTPUT record size, tape label infor- 
Mation, etc. 


e Program flow is controlled by: 


CONTINUE 
END 

PAUSE 
SEND STOP 


e The operational environment for OS/32 COPY is 
controlled by: 


List Designates a list device 
LOG Designates log device 

NOLOG Disables logging 

START Arguments determine command 


input device for batch or 
interactive operation, list 
and log devices. 
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e Information about current file assignments 
can be obtained by: 


FILES 


@e 0OS/32 file management functions are provided 
by the inclusion of: 


ALLOCATE 
DELETE 
RENAME 
File Positioning Commands: 
BRECORD 
FRECORD 
BFILE 
FPILE 
REWIND 
WFILE 


3.2 FUNDAMENTAL COPY OPERATIONS 


This section describes the basic capabilities provided by the 
COPY command. Copying to and from disc files, labelled and 
unlabelled tapes, and other devices, is described. End-of- 
file, end-of-volume, end-of-medium, and user specified termi- 
nators are discussed. Examples of several different COPY 
sequences are given. 


3.2.1 Copying a Dise File to Another File or Device 


To copy the contents of a dise file (fdl) to another disc 
file or device (fd2) you need only enter the command: 


CORY Eadl,;ta2 


For example, if the input file is FILE.CAL and the output de- 
Vice is CP:, you would enter: 


COPY FILE .CAL, CPs 
The file is then copied. When copying is completed, a message: 


EOF ENCOUNTERED - n RECORD(s) COPIED 
COPY COMPLETE - m FILE(S) COPIED 


is output, where n is the number of records and mis the num- 
ber of tiles copied. 


LE you wish to copy to a disce: file, you may explicitly allocate 


a new file or allow OS/32 COPY to automatically allocate the 
ELL, 
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Automatic allocation of output disc files and automatic de- 
letion and reallocation of disc files are discussed in later 
sections. 


3.2.2 Copying Unlabelled Magnetic Tapes 


This section describes 0S/32 COPY operations on unlabelled 
magnetic tapes. Section 3.2.3 describes labelled magnetic 
tapes. 


3.2.2.1 Copying to Unlabelled Magnetic Tape 


To copy the contents of a disc file to an unlabelled mag- 
netic tape, you may enter a single command: 


COPY fd1l,fd2 


Here fdl is the file descriptor of the input disc file and 
fd2 is the file descriptor of the magnetic tape drive con- 
taining the unlabelled magnetic tape. For example, you 
might enter: 


COPY A.CAL,MAGI: 


The data copied to the tape has the same record length as the 
input data, and is not blocked. 


If you want the data on the output tape to be blocked you can 
specify the record length and block size using the OUTPUT com- 
mand. In this case, the appropriate OUTPUT command would be 
in the form: 


OUTPUT fd,lrec/blk 


Here fd is the file descriptor of the magnetic tape drive, 
lrec is the record length in bytes of the data, and blk is 
the blocking factor, i.e. the number of records in a block. 


For example, if you want to write blocks of 80 byte records 
with 10 records per block when copying A.CAL, you would 
enter: 


OUTPUT MAG1:,80/10 
COPY A.CAL,MAGI: 


It 1S possible to avoid entering the file descriptor of the 
magnetic tape drive twice in the above command sequence. 
This is explained in the section describing implicit speci- 
fication of file descriptors. 


29-676 ROO 3/79 ase 


3.2.2.2 Copying from Unlabelled Magnetic Tape 


When the input data resides .on an unlabelled magnetic tape, 

you may use the INPUT command to enter the record length and 
blocking factor of the data if the default values are not suited 
to your needs. The defaults are 80 byte records and a blocking 
factor of l. 


The INPUT command has the same form as the OUTPUT command: 
INPUT fd,lrec/blk 


Here fd is the file descriptor of the magnetic tape drive, 
lrec is the record length, and blk is the blocking factor. 
The default for blk is l. 


Suppose you are copying data from an unlabelled tape mounted 

on MAG2: to a printer named PRT:. If the tape file consists 

of 120 byte records blocked 5 records per block, you can copy 
the data to the printer by entering: 


INPUT MAG2:,120/5 
COPY MAG2:,PRT: 


3.2.2.3 Copying Between Unlabelled Tapes 


If you want to copy between unlabelled tapes, you can use both 
the INPUT and the OUTPUT commands. To copy the data on MAG2: 
consisting of 120 byte records, blocked 5 records per block, 
to a tape mounted on MAGI: where the output data is unblocked, 
enter: 


INPUT MAG2: ,120/5 
OUTPUT MAGILL: ,120 
COPY MAG2:,MAGI: 


3.2.2.4 Default Values 


You can take advantage of default values for record length and 
block size to avoid entering the INPUT or OUTPUT commands. If 
you omit the INPUT command, OS/32 COPY assumes that data on an 
input tape is in the form of unblocked 80 byte records. If you 
omit the OUTPUT command, the record length of output data de- 
faults to that of the input data; the blocksize is 1 unless 

the input is blocked. In this case, the blocking factor on 
output is the same as on input. 
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3.2.2.5 More Examples 


Example: 


Suppose you want to copy the contents of file A.PRT to magnetic 
tape on MAG1:. The input file consists of 120 byte records. 
The output data is to be unblocked 120 byte records; the com- 


mand 1S: 


COPY A.PRT:,MAGI: 


In this case, no INPUT command is required because the record 
size associated with the disc file A.PRT is used. No OUTPUT 
command is required because the defaults are desired (1.e., a 
blocking factor of 1, a record size equal to the input data). 


Example: 


Here you want to copy the input file on MAGI]: to the tape on 

MAG2:. The data is blocked eight 126 byte records to a block 
and the output data is to be blocked the same way. The com- 

mand is: 


INPUT MAG1:,126/8 
COPY MAGI: ,MAG2: 


In this case, an INPUT command is required, to specify the 
desired record and block sizes. No OUTPUT command is re- 
quired because the defaults are desired (i.e., the record 
length and block size of the input data). 


3.2.3 Copying Labelled Magnetic Tape 


Using OS/32 COPY you can copy to or from labelled tapes. Tape 
labels may be in either IBM or ANSI format. OS/32 COPY copies 
Single-file multi-volume tapes. It does not support multi-file 
labelled tapes. For a description of labelled tape formats see 
the Appendix. 


To use labelled tapes, use the INPUT or OUTPUT command to enter 
necessary label and tape handling information followed by a COPY, 
VERIFY, or DISPLAY command. 


Output labelled tapes must first be prepared by using the TAPE 


LABELLER program. See the Appendix for the operation of the 
TAPE LABELLER program. 
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3.2.3.1 Copying from Labelled Tapes 


In order to copy data from a labelled tape, use the INPUT 
command to enter information about the tape file. 


You must enter the fiie descriptor of the tape drive on 
which the tape is mounted and the keyword LABEL. 


If you enter a record length and blocking factor, these 
parameters are compared to those written on the tape label. 
A mismatch causes the COPY, VERIFY, or DISPLAY operation to 
be rejected. 


Similarly, you can enter a file identifier and a set of vol- 
ume identifiers. If you do, they are checked against the 
label and a mismatch causes the COPY, VERIFY, or DISPLAY 
Operation to be rejected. If you omit one or both of these 
parameters, the corresponding information on the tape label 
is ignored. 


The format of the INPUT command is: 


INPUT fd [[{,lrec]/blk] [, LABEL] [, FNAME=fn] 
{, VOLID=(nl,...)][,PAD=xx] 


where: 

Ea .ils the file descriptor of the tape 
drive. 

lrec is the record length. 

D1lk is the: blocking factor. 

LABEL Signifies that the input tape is 
labelled. 

fn is the file identifier of the tape 
file, from. 1-to.17 character alipha=. .; 
numeric string: 

ae is from 1 to 6 alphanumeric charac- 


ters. If more than one volume id 

is listed, the id's are separated 

by commas and enclosed in paren- 

theses. The parentheses may be 

omitted for a single tape volume. 

The input tape volumes must be 

mounted in the order indicated by 

the list of volume id's. . - 


3-6 29-576 ROO 3/79: 


xX are two hexadecimal digits used to 
specify the pad character. A record 
of all pad characters will be ignored. 
The default is FF. 


The file descriptor of the tape drive must be the first 
parameter entered. The other parameters may be entered in 
any order. If you must use more than one line to enter all 
the data, you may do so. A line whose last non-blank char- 
acter is a comma is assumed to be continued on the next line. 
You can enter as many as 20 volume id's in addition to other 
parameters by using continuation lines. 
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Example: Suppose you want to copy a labelled tape file re- 
Siding on a single tape volume to a disc file. The record 

length of the input file is 256 and the file identifier is 

LABDATA. You do not want to check the volume id. The fol- 
lowing sequence of commands can be used: 


ALLOCATE LAB.DTA,IN, 256 

INPUT MAGI: , LABEL, FNAME=LABDATA 
COPY MAGI: ,LAB.DTA 

REWIND OUTPUT 

VERIFY 


Note that the labelled tape is automatically rewound. 


The last two commands are only required if you wish to ver- 
ify that the data was copied correctly. The ALLOCATE command 
could have been omitted and COPY would have automatically 
allocated an indexed file with the proper record length. 

See below for details on automatic allocation of output files. 


Example: Suppose you want to copy a labelled tape file to 
cards using the card punch CP:. The tape file has no file- 
name and you do not know the volume id, but you do want to 
check that the input data consists of 80 byte records blocked 
i> to .2- block. ‘Enter: 


INPUT MAG3: ,80/15,LABEL 
COPY MAG3:,CP: 
VERIFY MAG3:,CR: 


Here again the VERIFY is optional. The device CR: is a card 
reader which is loaded with the cards punched during the COPY 
operation. 


Example: Data file BIGJOB resides on three tape volumes whose 
volume id's are 606100, 606101, 606102. You want to copy the 
data to an unlabelled tape. The record length of the data is 
120 bytes; you want to block the output data 50 records per 
block. Enter the following commands: 


INPUT MAGILL: , LABEL, FNAME=BIGJOB, 
VOLID= (606100,606101,606102) 
OUTPUT MAG2: ,120/50 

COPY 


Note that no arguments are used with the COPY command since 
both the input and output files are previously established. 
When the first volume has been copied, a message is output: 


MOUNT NEXT VOLUME 606102 ON INPUT FOR MAGI: 
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The input tape is automatically rewound. You should now mount 
the next volume and enter the CONTINUE command to resume copy- 
ing. 


If OS/32 COPY is executing in batch mode, it pauses after the 
above messages are output. When the operator enters CONTINUE, 
the copy operation is resumed. 


The same procedure is followed when the second volume has been 
copied. 


3.2.3.2 Output Labelled Tapes 


The TAPE LABELLER Program must be used to initially create 
a labelled tape before it can be used for output. The oper- 
ation of this program is described in the Appendix. 


Writing labelled tapes is similar to reading them but there 
are several more parameters to consider. 


The format of the OUTPUT command used with labelled tapes is 
as follows: 


OUTPUT fd[{[,lrec]/blk] [, LABEL] [, FNAME=fn] 
[, EXPIRY=yyddd] [,VOLID=(nl,...)] [,PAD=xx] 


where: 


Ed is the file descriptor of the tape 
drive on which the tape is mounted. 


LABEL Signifies that the output tape is 
labelled. 


lrec is the record length; if omitted 
the default is the same as input 
record length. 


blk 1s the blocking factor; if omitted, 
the default is 1, unless the input 
is a tape in which case it defaults 
to the input blocking factor. 


fn is the file identifier, alto 17 
character alphanumeric sequence. 
If omitted, the filename field in 
the tape label is filled with blanks. 
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yyddd 


KX 


ni 


Example: Suppose you want to copy a disc file, 
The input record length is 80. 


labelled tape. 


is the expiration date expressed 
as a two digit year and a three 
digit day. If the expiry date 
is supplied, it is compared to 
the date in the expiry-date field 
in the label. If the specified 
date is less than the tape's ex- 
piry date, a message is logged 
and the command is terminated. 
Otherwise the new expiry-date 

is written on the label, and the 
current date is inserted in the 
creation date field. 


are two hexadecimal digits used 

to pad the last block of the out- 
put file if the number of records 
in the file is not a multiple of 


- the blocking factor. The default 


is FF. 


is from 1 to 6 alphanumeric char- 
acters specifying the volume id. 
If there is a single volume id, 
the parentheses may be omitted. 
If more than one volume id is 
given, the list should be sepa- 
rated by commas and enclosed in 
parentheses. More than one com- 
mand line can be used to enter 
the list of volids; 1f the last 
non-blank character on a line is 
a comma, the next line is treated 
as a continuation of the previous 
one. 


tape has volume id 789789. Enter: 


OUTPUT MAG2:,80/10,LABEL,FNAME=STAPE.FTN, 


VOLID=789789 


COPY S.FTN,MAG2: 


Sek IN; 
The output 


to a 


The output data is written with a blocking factor of 10. 


The expiry date is not cnecked, 


hexadecimal FF. 


and the pad character is 
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Example: Suppose you want to copy a card file from card 
reader CR: to a labelled tape. This new data should re- 
main valid until January 1, 1989. Suppose you want to 
block the records 10 records per block and pad the last 
block with zeros. No filename is to be given to this 
tape file. Enter: 


OUTPUT MAG1: ,80/10,LABEL, EXPIRY=89001, PAD=00 
COPY CR: ,MAGI: 

(cards are repositioned in card reader) 
VERIFY 


The last command is only required if verification is de- 
Sired. If the date in the expiry-date field of the label 
is later than the specified date in the OUTPUT command, 

a message is output and the command terminates. 


Example: Suppose you want to copy the data on a 4 volume 
tape file to another tape file. Enter: 


INPUT MAG1:,256/10,LABEL, FNAME=BIGDATA, 
VOLID=(LIlI1l11I1,liliit2,li1lll3,111114) 
OUTPUT MAG2:, LABEL, FNAME=BIGDATA2, 
VOLID=(FRED1,FRED2,FRED3,FRED4) 
COPY 


Here the output tape uses the record length and blocking 
factor of the input data. The expiry-date of the output 
tape is ignored and the pad character is hexadecimal FF. 
When it is necessary to chance either an input or an out- 
put volume, a message is output: 
MOUNT NEXT VOLUME xxxxxx ON} INPUT FOR fd 
on 


The tape is automatically rewound. When you have mounted 
a new tape (volume xxxxxx) on device fd, enter: 


CONTINUE 


3.2.4 Copying To and From Other Devices 

If you are copying to or from devices other than magnetic 
tape, you need only enter the COPY command with input and 
output file descriptors as arguments: 


COPY £42,102 
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Here fdl is the input file descriptor and fd2 is the output 
file descriptor. For example, to copy from card reader CR: 
to printer PRT:, you would enter: 


COPY CRs5-PRI: 


OS/32 COPY determines the record lengths of the input and 
output devices. 


3.2.5 User Specified Terminator 


In order to terminate the COPY operation entered above, you 
would end the card deck with a card containing a terminator 
sequence. By default this sequence is /* in colums 1 and 

2 followed by all blanks on the rest of the card. This 
card is not copied. You can choose your own terminator se- 
quence by using the TERMINATOR parameter of the OPTIONS 
command. For example, to specify the terminator characters 
EOF, you enter: 


OPTIONS TERMINATOR=EOF 


The sequence of terminator characters is one to four char- 
acters long with no imbedded blanks or commas. The rest 
of the record must consist of blanks. You can choose to 
have no terminator sequence at all by entering: 


OPTIONS NOTERM 


This option remains in effect until you enter another OPTIONS 
command with the TERMINATOR parameter. You might choose the 

NOTERM option if you were copying data from tape or disc and 

you wanted all records to be copied until the physical end of 
file was reached. 


The TERMINATOR sequence is only checked when copying in ASCII 
mode. The mode can be set in the OPTIONS command. The de- 
fault is ASCII mode. 

To copy a binary file such as a task image, which should only 
be terminated by a file mark, you should copy in binary mode. 
To set binary mode, enter: 


OPTIONS BINARY 
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3.2.6 Handling of End-of-File, End-of-Volume and End-of-Medium 
Conditions 


In most cases, execution of the COPY command continues until 
an end-of-file is encountered on the input file. At that time 
a message is logged indicating the number of records that have 
been copied. Then the next command is read from the command 
device. However, conditions such as end-of-volume and end- 
of-medium can interrupt or terminate the COPY command. 


3.2.6.1 End-of-File (EOF) 


The end-of-file condition can arise as follows, depending upon 
the file or device characteristics: 


DEVICE/FILE TYPE EOF CONDITION 
ASCII devices (e.g. card ASCII Terminator sequence 


reader, printer, terminal) 


Unlabelled Magnetic Tape Filemark 
Labelled Magnetic Tape EOF label 
Indexed file after processing of 


last logical record 


Contiguous file (PSEUDO after processing of 
FILE MARK OPTION disabled) last physical record 
Contiguous file (PSEUDO after processing of 
FILE MARK OPTION enabled) pseudo file mark or 


last physical record. 
An end-of-medium condition on contiguous files is treated as 
an end-of-file. When encountering an end-of-file condition 
while copying a file, OS/32 COPY issues the message: 


EOF ENCOUNTERED -n RECORDS COPIED 
END OF MEDIUM 


The pseudo filemark option (PSFM) determines whether file 
marks are recognized on contiguous files. The PSFM option 
is enabled or disabled using the OPTIONS command: 
OPTIONS PSFM (to enable the pseudo file mark option) 
OPTIONS NOPSFM (to disable the pseudo file mark option) 


The default is PSFM. 
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You can take advantage of the filemark option (FM/NOFM) to 
specify that an end-of-file indicator is to be copied. When 
the FM option is set, which is by default, an end-of-file 
indicator is written on the output file whenever end-of-file 
is reached on input (only if the output file is a disc file 
that supports file marks or magnetic tape). If the input 
file is a contiguous file, end-of-medium on input is treated 
as end-of-file. 


The NOFM option is set by entering: 
| OPTIONS NOFM 


When NOFM is set, no filemark is written on the output file 
when end-of-file is encountered on input. However, you may 
enter the WFILE command to write a filemark. 


The NOFM option is useful when you want to concatenate two 
data files. For example, to concatenate A1.DTA and A2.DTA 
onto a magnetic tape mounted on MAG2: you would enter the 
following commands: 


OPTIONS NOFM 
COPY A1L.DTA,MAG2: 
OPTIONS FM 

COPY A2.DTA,MAG2: 


The purpose of the second OPTIONS command is to cause a file- 
mark to be written at the end of the data copied as a result 
of the second COPY command. The WFILE command may also be 
used to accomplish this. 


3.2.6.2 End-of-Volume (EOV) 

On input devices other than labelled tapes, end-of-volume 
occurs when two successive end-of-file conditions occur on 
the input file. The COPY, VERIFY, or DISPLAY operation in 


progress is terminated. 


On labelled tapes, end-of-volume is defined on input by an 
end-of-volume label. 


When end-of-volume occurs on input from a labelled tape, a 
message is logged: 


MOUNT. NEXT VOLUME xxxxxx ON INPUT FOR fd 
The volume identifier xxxxxx names the next volume to be 


read and fd is the file descriptor of the input device. The 
tape is automatically rewound. 
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The COPY, VERIFY or DISPLAY operation in progress can be 
continued by entering the CONTINUE command or terminated 
by entering another command. If OS/32 COPY is in batch 
mode, it pauses after issuing the end-of-volume message 
and continues the COPY, VERIFY or DISPLAY operation in 
progress when CONTINUE is entered. 


On output, end-of-volume only occurs on magnetic tapes. 
When the end of a reel of tape is detected, a message is 
logged. For labelled tapes, the message is: 


MOUNT NEXT VOLUME xxxxxx ON OUTPUT FOR fd 


The volume idendifier xxxxxx names the next volume to be 
written and fd is the file descriptor of the output device. 
An end-of-volume label is written on the tape and the tape 
is rewound. 


For unlabelled tapes, one filemark is written followed by 
an end-of-volume identifier and one filemark, and the fol- 
lowing messages are logged: 


END OF VOLUME -n RECORDS | COPIED 
VERIFIED 
DISPLAYED 
MOUNT NEXT VOLUME FOR fd 


where n is the number of records processed up to the point 
of end-of-volume. 


The COPY, VERIFY or DISPLAY operation in progress may be 
continued as described above. 
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3.2.6.3 End-of-Medium (EOM) 


End~-of-medium can occur on input from a contiguous file or 
On output to either a contiguous or an indexed file. When 
reading from a magnetic tape, the end-of-tape marker is 
ignored and OS/32 COPY continues to read until it encounters 
an end-of-volume condition. When writing to a magnetic tape, 
the end-of-tape marker is interpreted as end-of-medium. 


When 0S/32 COPY encounters an end-of-medium condition while 
copying from a contiguous file, it issues a message: 


END OF MEDIUM - n RECORD(S) { COPIED 
VERIFIED 
DISPLAYED 


where n is the number of records processed to the point of 
end-of-medium. 0OS/32 COPY then treats the end-of-medium 
condition as an end-of-file. The number of records is only 
output if n is greater than @. 


When OS/32 COPY encounters an end-of-medium condition on out- 
Put tO a disc file, it treats the condition as an I/O error. 
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3.3 MORE ELABORATE COPY OPERATIONS 


This section explains: implicit specification of input and 
output files; copying multiple files or part of a file; auto- 
matic allocation of output files; using protection keys for 
disc files; and, variable length record processing. 


3.3.1 Implicit Specification of Input and Output Files 


When you enter a file descriptor by using the INPUT command 

or by specifying the file descriptor as the first parameter 

of the COPY, DISPLAY, or VERIFY commands, you establish this 
file as the current input file. Until another file descriptor 
is entered as the first parameter in one of these commands, 
this file remains the input file. 


Similarly, by entering a file descriptor using the OUTPUT 
command, Or as second parameter of the COPY or VERIFY com- 
mand, you establish a file as the current output file. 


Once a file has been established as the input file or out- 
put file, you can enter it implicitly in the commands INPUT, 
OUTPUT, COPY, VERIFY, and DISPLAY by entering an asterisk *. 


For example, suppose you want to copy a tape mounted on MAGI: 
to the printer PRT:. The data on the tape is in the form of 
120 byte records blocked 15 records per block. You would 
enter: 


INPUT MAG1:,120/15 
COPY *;PRYT; 


The first command establishes MAGI]: as the input file as well 
as describing the input data. The asterisk in the COPY com- 
mand implicitly refers to MAG1:. By entering PRT: in the 
COPY command, you have established PRT: as the output file. 
You may use an * to implicitly designate this output file in 
subsequent commands. 


For example, suppose there is a second data file on the tape 
mounted on MAGI: which consists of 80 byte records blocked 

10 to a block. Since both the input and output files have 
already been established, you may copy the data to the printer 
by entering: 


INPUT *,80710 
COPY. =; 
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In case both input and output files are designated by aster- 
isks and no other arguments are to be entered, you can omit 
all arguments. In this case, the above command sequence 
cound be: 


INPUT *,80/10 
COPY 


The use of asterisks to implicitly designate files is op- 
tional. You may enter file descriptors whenever they are 
appropriate. OS/32 COPY determines whether a new input or 
output file is established and does not reassign the input 
or output logical unit if the current file is being refer- 
enced. 


If you want to use the current output file as an input file, 
or the current input file as the output file, it may be 
necessary to precede the COPY, VERIFY, or DISPLAY command 
with an INPUT or OUTPUT command, which ever is appropriate. 
The INPUT or OUTPUT command is necessary if the specified 
file has attributes other than the default attributes. For 
example: . 
OUTPUT DATA.R1,256 
COPY MAG1:,DATA.R1L 
INPUT DATA.R1,256 
DISPLAY DATA.RI1 


allows you to display the contents of DATA.RI. 
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3.3.2 Copying Multiple Files with a Single Command. 


An unlabelled magnetic tape may contain any number of data 
files separated by single filemarks. The end of a tape vol- 
ume is signified by a filemark, an end-of-volume indicator, 
and a filemark. 


By using the NFILES parameter of the COPY file or VERIFY 
command you can copy or verify several files on a tape, or 
all files on a tape volume. One restriction on copying 
multiple files is that they must all have the same record 
length and blocking factor. 


The NFILES parameter may also be used to copy several files 
contained in a contiguous file and separated by pseudo file- 
marks, or to copy a number of ASCII files on any medium where 
a terminator sequence is specified as a filemark. 


The formats of the COPY and VERIFY commands with the NFILES 
parameter are: 


COPY fd1l,fd2,NFILES=n 
VERIFY fdl,fd2,NFILES=n 


n can be a decimal integer or the keyword ALL. 
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When n is an integer, copying or verifying continues until 
the specified number of files has been processed, or until 
an end-of-volume is encountered, whichever comes first. If 
ALL is entered, copying or verifying continues until end-of- 
volume is encountered. 


Example: All files on a tape mounted on MAGI: are to be 
copied to a tape mounted on MAG2:. All the files 
consist of 256 byte records blocked 5 records to a block. 
The output data is to be unblocked. Enter: 


INPUT MAGI: ,256/5 
OUTPUT MAG2:,256 
COPY *,*,NFILES=ALL - 


The asterisks are required because of the presence of the 


NFILES parameter. The use of the asterisks is explained 
above. 


In order to verify the files copied above, enter: 
REWIND INPUT 


REWIND OUTPUT 
VERIFY *,*,NFILES=ALL 


32355 COpying Part. Of a File 

By using the NRECS parameter along with the file position- 
ing commands, you may copy or verify a portion of a file. 
The NRECS parameter may not be used with labelled tapes. 


The formats of the COPY and VERIFY commands with the NRECS 
parameter are: 


COPY fdl,fd2,NRECS=n 

VERIFY fdl,fd2,NRECS=n 
nis a decimal integer which indicates the number of records 
to be copied. Copying or verifying continues until the spec- 
ified number of records has been processed or until an end- 


of file is encountered, whichever comes first. 


Example: To copy the first 20 records of file B.CAL to PR:, 
enter: 


COPY B.CAL,PR: ,NRECS=20 
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Example: Suppose you want to copy and verify records 101 
through 200 from a tape mounted on MAGI: to a tape mounted 
on MAG2:. The record length of the data is 80 and the 
blocking factor is 5. You enter: 


INPUT MAGI: ,80/5 
OUTPUT MAG2:,80/5 
FRECORD INPUT, 20 
COPY*, *,NRECS=100 
BRECORD INPUT, 20 
REWIND OUTPUT 

VERIFY *,*,NRECS=100 


The FRECORD command skips the first 20 blocks or 100 records 
thus positioning the input tape at record 101. Similarly, 
the BRECORD command positions the input tape at record 101. 


Note that the arguments of the FRECORD and BRECORD commands 


denote physical records or blocks, whereas the NRECS para- 
meter denotes logical records. 
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3.3.4 Automatic Allocation of Output Files 


When copying to a disc file you may want to allocate a file 
and then immediately copy to the file. OS/32 COPY performs 
the allocation and the copy for you if you enter as the out- 
put file the file descriptor of a non-existent file. The 
File allocated has the same attributes as the input file. 

An indexed file has an index block size and data block size 
OF. wk 


Example: If you want to copy the file GOOD.TSK to a file 
of the same name on volume M301, you enter: 


COPY M300:GOOD.TSK,M301:GOOD.TSK 


If the input file is a contiguous file, the output file is 
allocated as a contiguous file of the same size. 


You may also cause an existing output disc file to be deleted 
and reallocated. You do this by entering the DELETE keyword 

after the output file descriptor. The current output file is 
deleted and a new output file is allocated following the same 
rules as if the file had not previously existed. 


Example: Delete the file A.OBTJ and reallocate before copying 
126 byte records from tape. Enter: 


INPUT MAGI: ,126 
COPY *,A.OBJ,DELETE 


The file is reallocated as an indexed file with index and data 
block size of 1 and 126 byte records. 
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If DELETE is not entered and you name as the output file an 
existing contiguous file or an existing indexed file that 
contains one or more logical records, a message is logged: 


NON-EMPTY OUTPUT FILE 


In interactive mode, you must enter CONTINUE to have the 
COPY instruction executed. In batch mode the COPY opera- 
tion is executed without requiring CONTINUE to be entered. 


3.3.5 Copying Disc Files with Protection Keys 


If you want to COPY, VERIFY, or DISPLAY disc files that 
have non-zero protection keys, you must use the INPUT and 
OUTPUT commands to enter the keys so that the files can be 
assigned. The format of the INPUT and OUTPUT commands in 
this case is: 


INPUT fd,KEYS=xxxx 

OUTPUT fd,KEYS=xxxx 
Here xxxx 1s the ‘four hexadecimal digit protection key of 
the file, fd. The file must exist when these commands are 


entered. 


Example: Copy and verify the file IMPORT.DTA to the file 
IMPORT2.DTA. The keys of both files are E34A. Enter: 


INPUT IMPORT.DTA,KEYS=E34A 


OUTPUT IMPORT2.DTA, KEYS=E34A 
COP ey 
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3.3.6 Copying Variable Length Records 


It is possible to copy magnetic tapes or paper tapes having 
Variable length records. To do this, you enter the INPUT 
command with the file descriptor of the tape drive, the key- 
word VARIABLE, and the record size of the largest record on 
the tape. 


For example, suppose you want to copy a tape mounted on MAGI;, 
where the largest record may be 256 bytes, to a disc file, 
EXTM.FOQ, you enter: 


INPUT MAG1:,256,VARIABLE 
COPY MAGILL: , EXTM. F00 


The records are read from MAG]: and written to EXTM.F0O0; each 
record on EXTM.FOO is 256 bytes long. Each output record is 

padded with the current "fill" character. The fill character 
is initially X'20' and can be changed at any time by entering: 


OPTIONS FILL=xx 


where xx is the hexidecimal representation of the desired fill 
character. 


You may also copy variable length records to a device which 
Supports variable length records. Suppose you want to copy 
records from a magnetic tape, where the largest record is 80 
bytes, to paper tape, you enter: 


INPUT MAG1:,80,VARIABLE 
OUTPUT PTRP:,80,VARIABLE 
COPY 


Each output record is the same length as the corresponding in- 
put record. 


The VARIABLE keyword may also be used when copying to or from 
interactive devices. To copy from the interactive device CRT: 
to a magnetic tape mounted on MG3: and have each record padded 
with asterisks, you enter: 


OPTIONS FILL= 2A 
INPUT CRT: , VARIABLE 
OUTPUT MG3:,72 

COPY 


You would enter lines of varying length; each line is copied to 
a 72 byte record on MG3:. The magnetic tape records are padded 
out with the fill character * as specified in the OPTIONS com- 
mand. If you had not entered the OUTPUT command, each record 
output to MG3: is the same length as the corresponding input 
record. Had you entered the OUTPUT command without a specified 
record length or with the VARIABLE keyword, each output record 
would be the same length as the corresponding input record. 
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3.4 VERIFYING 


This section explains the use of the VERIFY command, its use 
with or without a previously issued COPY command, and also 
the effect of the CONTINUE option. 


3.4.1 Verification Following a Copy Operation 


After copying a file you may want to verify that the data 
was copied correctly. The VERIFY command allows you to do 
this. ,It compares the contents of two files record by rec- 
ord and halts if a pair of records are found which do not 
match. By using the CONTINUE option you may also list all 
pairs of records which differ in the two files. 


Before you can verify that the data you have copied is cor- 
rect, you must reposition the input and output files. 


For disc files use the REWIND command to position the files 
to the beginning. You may also use REWIND to position to 

the first file of data on a magnetic tape. For data on mag- 
netic tape which begins just after a filemark, you must use 
both the BFILE and FFILE commands. Labelled tapes are auto- 
matically rewound. For multivolume verification, the volumes 
must be remounted. 


The following examples show how to verify files following a 
COPY. Notice that the file descriptors, once entered in the 
COPY command, do not have to be re-entered. 


Example: Copy and verify disc file A.CAL with B.CAL. 


COPY A.CAL,B.CAL 
REWIND INPUT 
REWIND OUTPUT 
VERIFY 


Note that the output file is used as a second input file for 
the VERIFY command. 


Example: Copy and verify disc file A.CAL with a tape mounted 
on MAG2:. The tape is at the load point at the time the first 
command is entered. 


COPY A.CAL,MAG2: 
REWIND INPUT 
REWIND OUTPUT 
VERIFY 
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Example: Copy and verify file C.CAL with the same tape used 
above. The tape is positioned just beyond the filemark end- 
ing the first file copied. After the COPY, the tape is back- 
spaced two file marks, followed by forwarding one file mark 
in order to position the tape to perform the verify operation. 


COPY °C.CAL,* 
REWIND INPUT 
BFiILE OUTPUT, 2 
PEYILE OUTPUT 
VERIFY 


If a pair of records does not match when a VERIFY operation 
1S in progress, the first byte found which does not match is 
listed along with the associated records formatted in hexa- 
decimal and ASCII. This data is output to the list device. 
An end-of-file on one file that does not match the other file 
1s also reported. 


3.4.2 Verifying Without a COPY Command 


To verify two files which have not just been copied, you must 
explicitly name the files in the VERIFY command or in the IN- 
PUT and OUTPUT commands. In the case of disc files, it is 
only necessary to issue a VERIFY command: 


VERIFY AaPIN, Als PON 


If the input file is on magnetic tape use the INPUT command 
preceding the VERIFY command unless the default of unblocked 
80 byte records is applicable. 


Example: The input data on MAGI]: is in the form of 126 byte 
records blocked 10 to a block. The output file is a disc 
file: 


INPUT MAG1:,126/10 
VERIFY *, 2 LERsOBT 


If the output file is on magnetic tape you may need to use the 
OUTPUT command unless: the input data is also on tape and 

the record length and blocking factor of input and output data 
are the same; or, the output data has the same record length 
as the input and is unblocked. 


Example: The input data is in file FILR.OBJ, while the output 
data on MAG2: consists of 126 byte records blocked 10 per block: 


OUTPUT MAG2:,126/10 
VERE. LORS OB, * 
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Example: The output data is on MAGI]: and consists of un- 
blocked 126 byte records, the same as the input file. 


VERIFY FILR.OBJ,MAGI: 


3.4.3 Use of the CONTINUE/NOCONT Option 


The CONTINUE option in the OPTIONS command controls the VER- 
IFY command operation. You can use the VERIFY command with 

the CONTINUE option in effect to list all pairs of input and 
output records which differ. 


When program execution begins, the NOCONT option is in effect. 
Under this option execution of the VERIFY command terminates 
1f a pair of records is found which does not match. You may, 
however, enter the command CONTINUE if you wish verification 
to continue with the next pair of records. If you want veri- 
Fication to continue until at least one of the files reaches 
end-of-file, you should set the CONTINUE option. Enter: 


OPTIONS CONTINUE 
Since verification continues until end-of-file, it is possible 


that a large number of records will not match and a sizable 
amount of data is written to the list file. 
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3.5 DISPLAYING FILES 


The DISPLAY command may be used to produce a hexadecimal dis- 
play of a file. The display is output to the list device. By 
default, the list device is the command device if you are enter- 
ing commands interactively, or PR: if commands are being entered 
from a non-interactive device or file. 


You can change the list device by entering the LIST command: 
LIST fd 


If you want to produce a hexadecimal display of a file fd, you 
would enter: 


DISPLAY fd 
Example: To display the contents of a disc file A.OBJ, enter: 
DISPLAY A.OBJ 


If you want to DISPLAY a file residing on magnetic tape or a 
disc file which has non-zero protection keys, you must use 
the INPUT command. 


Example: Suppose you want to display the contents of a file 
of data on magnetic tape. The tape volume is on MAGI:; the 
data is in the form of unblocked 120 byte records. Enter: 


INPUT MAG1:,120/1 
DISPLAY MAGI: 


Example: To display the contents of a file on a labelled tape 
with file identifier DATA.DMP, enter: 


INPUT MAGI: , LABEL, FNAME=DATA. DMP 
DISPLAY MAGI: 


If you are entering the DISPLAY command after having entered 

a COPY, VERIFY, or another DISPLAY command, and you want to 
display the file which was the input file in the previous com- 
mand, you can enter: 


REWIND INPUT 
DISPLAY * 


Furthermore, if you enter DISPLAY with a file descriptor as 
argument, that file becomes the new input file. Subsequent 
COPY, VERIFY, and DISPLAY commands can use an * to implicitly 
designate that file. 
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The INPUT command must be used in order to display a file or 
device which has other than the default keys, record length, 
or blocking factor, and is not the current input file. 


The NFILES or NRECS parameter may be used with the DISPLAY 
command to display multiple files or a particular number of 
records ina file. Only one of these parameters should be 
entered in a command, and neither parameter can be used with 
labelled tapes. The format of the DISPLAY command used with 
these parameters ls: 


DISPLAY [fd] }) [,NFILES=n] 
[, NRECS=n } 


Example: Suppose an unlabelled tape mounted on MAGI: con- 
tains 3 files separated by file marks. The data in each 
file consists of 80 byte records blocked 5 records to a 
block. To produce a formatted dump of the files, enter: 
INPUT MAG1:,80/5 
DISPLAY *,NFILES=3 
3.6 FILE POSITIONING 
A set of commands is provided which are similar to the 0S/32 
commands for positioning files and writing filemarks. fThese 


commands cannot be used with labelled tapes, except REWIND. 


The file positioning commands can only be executed for files 
that support the operation indicated by the command. 


A table of device attributes is in the Appendix. 


The commands and their formats are: 


BFILE INPUT ({[,n] Backspace over a 
OUTPUT filemark 
BRECORD INPUT yo) Backspace a record 
OUTPUT 
FFILE INPUT f,n] Forward space over a 
OUTPUT {, ALL] filemark 
FRECORD INPUT [,n] Forward space a record 
OUTPUT 
REWIND INPUT Position to beginning 
OUTPUT of file/device 
WFILE LIST [,n] Write a filemark 
OUTPUT 
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These commands can only be applied to the current.input, out- 
put, and list files. The first file named in a COPY, VERIFY, 
DISPLAY or INPUT command is the current input file. The sec- 
ond file named in a COPY or VERIFY command or the file named 
in an OUTPUT command is the current output file. 


If you wish to position a file before using it in a COPY DIS- 
PLAY, or VERIFY command, you must use the INPUT or OUTPUT 
command before issuing one of the file positioning commands. 


Example: Suppose you want to write a filemark on a tape 
mounted on MAGI: before copying to the tape, you would enter: 


OUTPUT MAGI: 
WFILE OUTPUT 
COPY X.Y,MAGI: 


3.6.1 Forward File and Backward File 


These commands skip over one or more filemarks. FFILE skips 
forward while BFILE skips backward. Filemarks on magnetic 
tape or pseudo filemarks on contiguous files are considered 
to be filemarks by these commands. However, pseudo filemarks 
are ignored unless the PSFM option is set. A terminator 
String, if in effect, is ignored. 


The parameter n, a decimal integer, specifies the number of 
filemarks to be skipped. If omitted, the default is l. 


Example: To skip over 3 filemarks on the input file and skip 
back over one filemark on the output file, enter: 


FFILE INPUT, 3 
BREIL. OUTPUT 


Command execution of FFILE terminates when the indicated num- 
ber of. filemarks have been skipped or when two consecutive 
filemarks or an end-of-file, or an end-of-volume condition 

is encountered. In order to skip forward to the end-of-volume, 
enter ALL instead of a decimal integer. 


BFILE terminates when the indicated number of filemarks has 
been skipped or when beginning-of-medium is encountered. 


After the execution of FFILE the file is positioned just be- 
yound the last filemark skipped. After the execution of BFILE 
the file is positioned just before the last filemark skipped. 


This means that FFILE positions to the end of a file if no 


file marks are encountered, BFILE positions to the beginning 
of a file if no filemarks are encountered. 
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3.6.2 Record Positioning 


The FRECORD and BRECORD commands skip forward or backward over 
one or more records of the input or output files. The number 
of records skipped is determined by the parameter n which is 
entered as a decimal integer. If n is omitted, the default is 
a 


The execution of a FRECORD or BRECORD command is terminated 
when the n records have been skipped or when end-of-file is 
encountered, whichever comes first. Terminator strings are 
not considered filemarks when executing these commands. 


Example: To copy record 51 through and including record 70 
of file A.CAL to the tape mounted on MAG2:, enter: 


INPUT A.CAL 
FRECORD INPUT, 50 
COPY *,MAG2: ,NRECS=20 


3.6.3 REWIND Command 


Using the REWIND command, you can rewind the current input or 
output file. This command positions the file at its beginning. 


Example: To rewind a tape mounted on MAG2:, enter: 


OUTPUT MAG2: 
REWIND OUTPUT 


3.6.4 Writing Filemarks 


With the WFILE command, you can write one or more filemarks on 
either the list or output device. The parameter n specifies 

the number of filemarks to be written. Filemarks are written 
only to devices which support filemarks. Terminator strings 

are not written as filemarks by the WFILE command. Although 

the user may specify writing a filemark to an indexed file, a 
filemark is not actually written. This is consistent with 0S/32 
processing. 


Example: To write two end-of-file marks on MAG2:, enter: 


OUTPUT MAG2: 
WFILE OUTPUT, 2 
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3.7 OPTIONS, LIST, NOLOG and FILES Commands 


3.7.1 OPTIONS Command 


By using the OPTIONS command you can set one or more options 
which govern OS/32 COPY command execution. Once set, a par- 
ticular option remains in effect until it is changed by a 
subsequent OPTIONS command. Also, default options are in 
effect when program execution begins. 


The form of the OPTIONS command is 
OPTIONS optl,opt2,... 


Here optl,opt2,... are options; these can be entered in any 
order. Only those options which are entered are changed. The 
others remain in effect. 


Entering the OPTIONS command with no parameters causes the 
current setting of all options to be output. 


3.7.1.1 Filemark Recognition 


The NOFM/FM option suppresses or causes the writing of a file- 
mark on the output file when end-of-file on input is reached. 
The default is FM. 


Example: Concatenate two input files onto a magnetic tape. 
The files are Al1.STR and A2.STR. The record length is 80 
bytes and the tape is to be unblocked. You would enter: 


OPTIONS NOFM 
COPY A1.STR,MAGIL: 
OPTIONS FM 

COPY AzZaSitk,* 


Resetting the option to FM causes a filemark to be written on 
the tape when end-of-file is reached on A2.STR. 

3.7.1.2 ASCII/BINARY Mode 

The ASCII/BINARY option sets the I/O mode. Some devices sup- 
port only ASCII I/) while others support both BINARY and ASCII. 


The Appendix contains a table of device attributes which shows 
the modes each device supports. The default mode is ASCII. 
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3.7.1.3 Pseudo Filemark Recognition 


The PSFM/NOPSFM option determines whether or not a pseudo 
filemark (X'1313' at the beginning of a record), is recog- 
nized as an end-of-file on contiguous disc files.” 


Thr NOPSFM option is useful when copying binary data, such 
as task images, from a contiguous file. The default is PSFM. 


Example: Suppose you have just established the task USEFUL.TSK, 
using TET/32. To copy it to magnetic tape: 


OPTIONS NOPSFM, BINARY 
COPY USEFUL. TSK, * 


The BINARY option disables recognition of a possible embedded 
ASCII terminator sequence which might be in effect. 


3.7.1.4 Terminator Sequence 


You can use the TERMINATOR option to establish a sequence of 
one to four characters as an end-of-file indicator for the 
COPY, VERIFY, and DISPLAY commands. The NOTERM option dis- 
ables all terminator sequences. The ASCII option must be set 
in order for a terminator string to be recognized. The de- 
fault terminator is /*. A record must not only begin with 
the terminator sequence but must also consist entirely of 
blanks beyond the terminator in order to be recognized as 
end-of-file. The form of the command is: 


OPTIONS TERMINATOR=xxxx 
where xxxx is a 1-4 character sequence without embedded blanks 
or commas that establishes this sequence as the current termi- 
nator. Entering: 


OPTIONS NOTERM 


Suppresses the current ASCII terminator string. Filemarks 
or pseudo-filemarks are still recognized. Entering: 


OPTIONS TERMINATOR 
causes the current terminator string to be displayed. 
Example: Suppose you wish to copy a deck of cards to tape. 
The end of the card deck is signalled by a card with /@ in 
columns 1 and 2 and all blanks in columns 3-80. You would 


enter: 


OPTIONS TERMINATOR=/6¢ 
COPY CR: ,MAGI: 
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3.7.1.5 Use of CONTINUE/NOCONT 

The CONTINUE/NOCONT option determines the action of OS/32 
COPY when, during a VERIFY operation, a mismatch occurs. 

Under the option NOCONT, which is the default, verifying 


halts. Under the option CONTINUE, verifying continues 
until an end-cf-file is reached. 


3.7.1.6 FILL Character Designation 
The FILL option is used when the output record is longer 
than the input record in a COPY command. In this case, 


the longer output record is padded with the FILL character. 


The default FILL character is X'20', which is the ASCII 
representation for a blank space. 


You can set the FILL character to any 2 digit hexadecimal 
value by entering: 


OPTIONS FILL=xx 
Entering: 
OPTIONS FILL 


displays the current fill character in hexadecimal format. 
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3.7.2 LIST Command 


If you want to change the device used by the DISPLAY and 
VERIFY commands for output, you use the LIST command. 


Example: 
List PRI: Change the list device to PRI: 
DISPLAY FILEL Display FILE1l on PRI: 
REWIND INPUT Rewind the file 
LIST PR2: Change the list device to PR2: 
DISPLAY Display FILE1 on PR2; 


3.7.3 LOG and NOLOG Commands 


It is possible to change the device to which commands and 
error messages are logged. You may also disable logging 
using the NOLOG command. If the command device is interac- 
tive, error messages are still written to the command device 
whether or not logging is enabled. 


Example: 
LOG PRI: Change the logging device 
to PRI: 
NOLOG Disable logging 


3.7.4 FILES Command 


The FILES command allows you to display the current input, 
output, list, and log devices. The FILES command has no 
arguments. The current attributes of the input and output 
files as established by the INPUT and OUTPUT commands are 
also displayed. The format of the display is given in 
Chapter 4. 
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3.8 BATCH OPERATIONS 


OS/32 COPY operates in interactive mode when the command 
device is interactive and in batch mode when the command 
device is not interactive. 


For the most part, program operation is identical in the 
two modes. The differences occur in these areas: (1) De- 
fault assignments of the list and log devices, (2) Error 
and end-of-volume handling, (3) Handling of non-empty out- 
put files in the COPY command, (4) SEND STOP recognition. 


3.8.1 Default Assignments of List and Log Devices 


The defaults for list and log devices are given in Chapter 
2. You may issue the NOLOG command in batch mode to sup- 
press logging. This results in no record of your batch run. 
Therefore, it is advisable to use the default device which 
is also the list device or to specify a file or device for 
logging. | 


3.8.2 Error and End-of-Volume Handling 


Error handling is described in detail in Chapter 5. In 
batch mode, any syntax error or unsuccessful program oper- 
ation other than I/O errors to the input, output, list, or 
log devices causes termination. In case of I/O errors or 
end-of-volume conditions requiring your attention, a message 
is logged to the console device and the program is paused. 

If you continue OS/32 COPY, the operation which was in prog- 
ress when the I/O error or end-of-volume occurred is resumed. 


3.8.3 Handling of Non-empty Output Files in the COPY Command 


An output file is considered non-empty if it is a contiguous 
file or if it is an indexed file and has at least one logical 
record. 


If you designate a non-empty file as the output file in inter- 
active mode, you are warned that you may be destroying data 

in your copy operation. You may enter CONTINUE to perform the 
copy anyway. In batch mode the copy is done without the need 
for a CONTINUE command; however, a message is logged inform- 
ing you that you may have destroyed data. 


3.8.4 SEND STOP Processing 


SEND STOP has no effect in batch mode. 
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CHAPTER 4 
OS/32 COPY REFERENCE GUIDE 


4.1 INTRODUCTION 


This chapter discusses 0S/32 COPY file handling command syntax, 
followed by detailed descriptions of each OS/32 COPY command. 


4.2 FILE HANDLING 


Throughout this Chapter the words "file" and "device" are used 
interchangeably to mean any direct access file or non-direct 
access device which can be designated by an OS/32 file descrip- 
tor. Occasionally, a particular kind of device or direct access 
file is indicated. This should be clear from the context and 
from designations such as "disc file" or "magnetic tape." 


4.2.1 "Current" File Maintenance 


OS/32 COPY keeps track of the current input, output, list, 

log, and command files. When you enter a file descriptor as 

an input or output file in a command, you establish that file 
as the current input or output file until you designate a new 
input or output file. Similarly, specifying a list or iog file 
in the START parameters or in a LIST or LOG command establishes 
that file as the current list or log file until you enter a new 
LIST or LOG command. 


A file is established as the current input file by entering its 
file descriptor as the first parameter of the INPUT, COPY, VER- 
IFY, or DISPLAY commands. A file is established as the current 
Output file by entering its file descriptor as the first param- 
eter of the OUTPUT command, or as the second parameter of the 
COPY or VERIFY command. 


4.2.2 Determination of File Attributes 


Whenever possible, OS/32 COPY determines the file attributes of 
the input, output, list, log, and command files. These attri- 
butes are: record length, ASCII/BINARY I/O, interactive/non- 
interactive, capable of being rewound, support for filemarks, 
support for backspace and forwardspace for records and for 
filemarks. 
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Attributes which cannot be determined are ASCII/BINARY mode 
for files supporting both, record length and blocking factor 
for magnetic tape, block sizes and keys for disc files, and 
information pertinent to labelled tapes. There are default 
values for these attributes. You can specify other values, 
using the INPUT, OUTPUT, and OPTIONS commands. 


The defaults for input files are as follows: 


ATTRIBUTE DEFAULT 
ASCII/BINARY ASCII 
Record length 80 bytes or physical 
record length 
Blocking factor a 
Keys 0000 
Mag tape unlabelled 
Labelled tapes 
File name blank 
Volid blank 
Expiry-date blank 
Pad character X'FE' 


The defaults for the output file are taken from the input 
file attributes. However, a magnetic tape must be explicitly 
declared to be labelled if labelled tape handling is desired. 
Defaults for labelled tape attributes are the same on input 
and output. 


4.2.3 Labelled Magnetic Tape 


OS/32 COPY copies tapes with IBM or ANSI labels. Labelled 
tape information is entered using the INPUT and OUTPUT com- 
mands. See the descriptions of the INPUT and OUTPUT commands. 


Single file, single volume and single file, multi-volume tapes 
may be copied and written. See Appendix D for a complete des- 
cription of tape and label formats. 


For input tapes, OS/32 COPY verifies the filename, record 
length, blocking factor, and volume id, if you enter the re- 
quired values in the INPUT command. For output tapes, the 
expiration date and volume id are validated if you enter the 
required values in the OUTPUT command. COPY also writes the 
filename, record length, blocking factor, and creation date 
on the tape. Only entire files may be copied from labelled 
tapes. End-of-file labels are written on an output labelled 
tape at the conclusion of each COPY command. 
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File positioning commands cannot be used with labelled tapes. 


OS/32 COPY rewinds a labelled tape at the end of each opera- 
tion. When the end of tape volume is reached, OS/32 COPY 
logs a message: 
MOUNT NEXT VOLUME [ volid] ON } INPUT FOR fd 
OUTPUT 


and rewinds the tape. Volid is output if volid's have been 
specified. 


In batch mode, the program pauses so that you may mount the 
next tape volume. Continuing the program causes the operation 
in progress to be resumed. 


In interactive mode, you can mount another tape, and then enter 
the CONTINUE command. If a command other than CONTINUE or 
PAUSE is entered, the current operation is terminated, and the 
new command is executed. 


4.3 COMMAND SYNTAX 


Commands consist of a mnemonic, followed by one or more blanks, 
followed by a list of parameters. 


Command mnemonics may be abbreviated. The minimum abbrevia- 
tion of each command is indicated by underlining in each command 
description. 


Commands may be entered in upper or lower case. 


A command is terminated by depressing the RETURN key in inter- 
active mode or by end of record in batch mode. 


4.3.1 Continuation of Commands 


Commands may extend over more than one line. A line terminated 
by a comma 1S considered to be continued on the next line. 

The commands that might not fit on a single line are the INPUT 
and OUTPUT commands. These commands can require additional 
lines when several volume ids are entered in a single INPUT or 
OUTPUT command. 
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4.3.2 Command Parameters 


The list of command arguments consists of positional para- 
meters optionally followed by keyword parameters. 


The positional parameters are: the input and output file 
descriptor in COPY and VERIFY; the input file descriptor 
in DISPLAY and INPUT; the output file descriptor in OUTPUT; 
and all parameters in ALLOCATE, and RENAME, FFILE, BFILE, 
FRECORD, BRECORD, and WFILE. 


Keyword parameters may appear in any order after the pos- 
itional parameters. In most cases there are default values 
for keyword parameters. When there are default values, the 
keyword parameters may be omitted. Keyword parameter ab- 
breviations are indicated by underlining. 


The following apolies to the »varameters: 
{ J brackets indicate optional parameters. 


{ j braces indicate a choice of parameters. 


4.3.3 Implicit Specification of a File Descriptor Parameter 


If a command requires an input or output file descriptor 
to be entered, and you wish to specify the current input 
or output file, you may enter an asterisk in place of the 
Elle descriptor. If both the current input and output 
files are to be specified, and no keyword parameters are 
to be entered, you may omit both asterisks and the comma. 
However, if you enter a keyword parameter, you must enter 
the asterisks. 


The following commands are acceptable and specify that 
the current input or output file is to be used in the 
commands. 


COPY *,* 

COPY 

INPUT *,80/10 
COPY *,*,NRECS=20 
COPY *,MAG3: 

COPY ABC.001,* 


The following commands are unacceptable. The presence of 
the keyword parameter, or of the file descriptor mean that 
an asterisk or file descriptor must be entered: 


COPY ,,NRECS=20 


COPY NRECS=20 
COPY MAG3: 
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4.4 O0S/32 COPY COMMANDS 


The following sections describe each OS/32 COPY command. 


4.4.1 ALLOCATE Command 


This command allocates a contiguous or indexed file ona 
disc. The command format can be one of the following: 


ALLOCATE fd, CONTIGUOUS, fsize [,keys] 
ALLOCATE fd, INDEX [, [lrec] [/ [bsize2[/isize] ] [,keys] 
where: 


fd is the file descriptor of the file to be 
allocated. 


fsize is the size of the contiguous file in sectors, 


keys are the write-read keys of the file. The keys 
are specified as a hexadecimal halfword; the 
first byte is the write key, the second byte is 
the read key. The default is zero for both keys. 


lrecl is the logical record length of the indexed 
file. The default is 126 bytes. 


bsize is the data block size in sectors of the indexed 
file. The default is l. 


isize ius the size of an indexed block in sectors. The 
default is l. 


This command might be entered when the user wants to use as 
an output file a file other than the default output file gen- 
erated by the COPY command. 


Examples: 


AL THISFILE,CO,20 
Allocate a contiguous file consisting 
of 20 sectors. 


AL THATONE,IN, 80/5 
Allocate an indexed file consisting of 
80 byte records blocked in 5 sector 
DLOcCKS: 


AL THEOTH.ERL,IN,80/5/2,AA03 
Allocate an indexed file with 80 byte 
records, blocked 5 sectors to a data 
block, with 2 sectors to an index block, 
write key AA and read key 03. 
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4.4.2 BFILE Command 
This command skips backwards over one or more filemarks. 


The command format is 


BFILE / INPUT | [,n] 
QUTPUT 


where: 


INPUT specifies that the command applies toc the 
current input file. 


OUTPUT specifies that the command applies to the 
current output file. 


n is a decimal integer specifying the number 
of filemarks to be skipped. The default is l. 


‘On contiguous files and magnetic tapes, BFILE skips backwards 
over filemarks. When the command has been executed, magnetic 
tapes are positioned just before the last filemark skipped, 
while contiguous files are positioned on the last filemark 
skipped. In either case, the next read operation returns 

an end-of-file status. When the file specified is an indexed 
file, the file is positioned at the beginning. 


This command is only valid for devices that support filemarks. 
In order for filemarks to be recognized in contiguous files, 
the PSFM option must be set. See the OPTIONS command for in- 
formation on the PSFM option. 


This command cannot be issued for a labelled magnetic tape. 


Example: 
COPY A.CAL,MAGI: Copy a file to tape 
COPY B.CAL,MAGI: Copy another file 
BRILE: OUTPUT ;2 Position before filemark 


ending first file. 
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4.4.3 BRECORD Command 
This command skips backwards over one or more records. 
The command format is: 


BRECORD (sore ; [,n] 


OUTPUT 
where: 
INPUT specifies that the command applies to the 
CGUrTENnt anout file. 
OUTPUT specifies that the command applies to the 
Current. output file. 
n is a decimal integer specifying the number of 


records to be skipped. The default is l. 
When the file to be positioned is a blocked 
unlabelled magnetic tape, n signifies the 
number of blocks to be skipped beginning at 
the current position of the tape. 


BRECORD skips records until n records have been skipped or 


until a filemark, end-of-medium, or end-of-file is reached, 
whichever comes first. 


This command cannot be issued for a labelled magnetic tape. 


Example: 
COPY A.CAL,PR: Copy file to printer 
BRECORD INPUT 5 Go back 5 records 


COPY *,PNCH: Punch last 5 records 
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4.4.4 CONTINUE Command 


This command resumes the execution of a command that was 
suspended due to an I/O error, a non-verify condition under 
Option NOCONT, the SEND STOP command, or to an end-of-volume 
condition on magnetic tape. CONTINUE is only effective in 
interactive mode. If entered in batch mode, the command has 
no effect. 


The command format is: 


CONTINUE 
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4.4.5 COPY Command 


4.4.5.1 Command Format 


The COPY command copies data from the input file to the 
output file. All or part of a single file may be copied, 
or more than one file can be copied with a single COPY 
command. 


The command format is: 


COPY: Shy [, NRECS=m] [, DELETE] 
fdl{ \fd2 [, NFILES=n] an 


where: 

fdl is the file descriptor of the input file 

fd2 is the file descriptor of the output file 

* denotes the current input or output file 

m is a decimal number up to 6 digits 
specifying the number of records to be 
copied. The default is all records 
until an end-of-file. 

n is a decimal number up to 6 digits 

in length specifying the number of files 

to be copied or the word ALL indicating 
that all files up to end-of-volume are 
to be copied. The default is 1 file. 

DELETE if entered, indicates that if fd2 1s an 


existing disc file, it is to be deleted 
and reallocated according to the attri- 
butes of fdl. 


4.4.5.2 Default Allocation and Record Lengths 


When the input file is a dise file or fixed record length 
device, its record length is determined by the program. 
When the input file is a magnetic tape, its record length 
and block size may be specified using the INPUT command. 
If the INPUT command is not entered, unlabelled tapes are 
assumed to be unblocked with a record length of 80 bytes. 
In the case of labelled tapes, this information is taken 
from the label if not specified in the INPUT command. 


29-676 ROO 3/79 4-9 


Output file attributes are also obtained by the program. 
If the output file is a disc file which does not exist, 

a file of the same type is allocated with the same attri- 
butes as the input file. For indexed files, the index 
and data block sizes are one. 


For magnetic tape, the record length and blocking factor may 
be specified using the OUTPUT command or the input record 
length is assumed. If the input file is blocked magnetic 
tape, the output data is blocked the same way. 


Blocked, unlabelled tapes are written with all blocks the 
Same size. However, the last block of a tape file may be 
smaller than the others. This depends on the blocking fac- 
tor and the number of records in the file. 


4.4.5.3 Existing Output Disc Files 


OS/32 COPY determines if the output file specified in an 
OUTPUT or COPY command is a contiguous file or if it is 

a non-empty indexed file. If it is either type, the fol- 
lowing message is logged: 


NON-EMPTY OUTPUT FILE 


If the program is in batch mode the COPY command is executed. 
If in interactive mode, you must enter CONTINUE to cause the 
COPY command to be executed. 


The above action only occurs the first time a file 1s estab- 
lished as the current output file in a COPY command that does 
not specify DELETE. 


An existing file may be deleted by entering the DELETE keyword 
in a COPY command. The specified output disc file is deleted 
and reallocated with the same file type and record length 

( and size for a contiguous file) of the input file. 

If the input file is a device, an indexed file is allocated. 

If the volume name is not specified, the default volume is used. 


4.4.5.4 NFILES and NRECS 


The parameter NRECS specifies the number of records to be 
copied. The default is the number of records in the file. 
Copying stops if an end-of-file 1s encountered on input. 


The parameter NFILES specifies the number of files to be 
copied. The default value is one. A file is terminated 
by a filemark or by an ASCII terminator. See the OPTIONS 
command for information on ASCII Terminators. 
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Copying terminates if an end-of-volume is encountered on in- 
put. End-of-volume is defined by two consecutive filemarks. 


After each file has been copied, a message indicating the 
number of records which have been copied in that file is 
logged. 


If NFILES=ALL is entered, all files are copied until end-of- 
volume occurs on input. 


4.4.5.5 End-of-—-Medium 


End-of-medium processing for magnetic tapes is intended to 
allow you to conveniently copy an input file to more than 
one tape volume. ) 


When physical end-of-medium is detected on an output tape and 
there are remaining input records to be copied, a filemark, 
and an end-of-volume indicator followed by another filemark 
are written on the tape, and the tape is rewound. If it is 
an unlabelled tape, a message is logged: 


END OF VOLUME-n RECORDS COPIED 
where n is the number of records copied so far. 


If the tape is labelled, an end-of-volume label is written and 
the tape is rewound. A message is logged: 


MOUNT NEXT VOLUME volid ON OUTPUT FOR fd 


where volid is the volume identifier of the next tape. It is 
only output if volids are specified in the OUTPUT command. 
Fd is the file descriptor of the magnetic tape drive. 


In batch mode, the program pauses. When it is continued, 
copying resumes. While the program is paused, you can mount 
the next volume. 


In interactive mode, you can mount another tape and then enter 
CONTINUE to cause copying to resume. If you enter a command 
other than CONTINUE or PAUSE, the previous COPY is terminated. 


OS/32 COPY assumes that the last file on an unlabelled input 
magnetic tape is followed by two file marks. When end-of- 
medium is encountered on an input tape, COPY continues to 
read until an end-of-volume indicator is read. End-of-medium 
on a contiguous file is treated like an end-of-file on input, 
and aS an error on output. 
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4.4.5.6 Copying Records With Different Record Lengths 


When the input record length exceeds the output record length, 
the input record is truncated before it is copied or verified. 


When the input record length is less than the output record 
length, the output record is padded with a fill character 
before it is copied. The fill character can be set by the 
FILL option in the OPTIONS command. The default is a hexa- 
decimal 20 (ASCII blank). 
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4.4.5.7 Completion of COPY command 


When the COPY command is successfully completed, a message is 
logged: 


COPY COMPLETE -n FILES COPIED 


where n is the number of files copied. 


4.4.5.8 Examples. 


COPY A.CAL ,B.CAL Copy one disc file to 
another. 
COPY A.CAL,B.CAL, DELETE Delete and reallocate 


output file; copy file 
A.CAL to B.CAL. 


COPY MAG1:,MAG2:,NFILES=ALL Copy all files from one 
tape to another. 


COPY A.CAL,PR: ,NRECS=100 Copy first 100 records 
tO. printer. 


INPUT MAGI1:,80/5 Input file is a blocked 
unlabelled tape with 80 
byte records, 5 records 


per block. 

OUTPUT MAG2:,80/1 Output file is an unblocked 
unlabelled tape. 

COPY Copy one file. 

COPY *,.* ,-NRECS=15 Copy first fifteen records 


of second file from the input 
tape to the output tape. 
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4.4.6 DELETE Command 


This command is used to delete a disc file. The command 
format is 


DELETE fd[,fd...] 


where: 


fd identifies the file to be deleted. 


A file may only be deleted if its read and write protection 
keys are zero and it is not currently assigned to any 
Logical Unit of any task. 


The only exception is when the current input, output, list, or log 


file is to be deleted. In this case, 0OS/32 COPY closes 
its own Logical Unit assignment and deletes the file. 


Examples: 


DELETE ART. XXX 


DELETE ART1L.D,ART2.D,ART3.D 
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4.4.7 DISPLAY Command 
This command displays a file in hexadecimal and ASCII format. 


The command format is: 
DISPLAY) *| J[,NFILES=m] 
fd [, NRECS=n] 


fd is the file descriptor of the file to be 
displayed. If * is entered the current 
input file is displayed. If a file des- 
criptor is entered, that file is estab- 
lished as the new input file. 


where: 


m is a decimal number up to 6 digits in 
length specifying the number of files 
to be displayed or the keyword ALL in- 
dicating that all files are to be 
displayed up to end-of-volume. The 
default is l file. 


n 1s a decimal number up to 6 digits 
specifying the number of records to 
be displayed. If nis not entered, 
all records are displayed until end- 
of-file. 


The display is output to the list device. 
No filemarks are written when input end-of-file is reached. 
However, you can write a filemark on the list device using 


the WFILE command. 


If the file to be displayed has other than the default attri- 
butes, the INPUT command must be used before the DISPLAY command. 


Examples: 

DISPLAY M.DTA Display the file M.DTA on 
the list device 

DISPLAY * Display the current input 
file on the list device 

DISPLAY *,NRECS=1 Display one record of the 
current input file. 

INPUT MAG1:,120/1 Display two files from 

DISPLAY *;NPLLES=2 MAGI: 
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4.4.8 END Command 
This command terminates OS/32 COPY. The command format is: 


END 
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4.4.9 FFILE COMMAND 
This command skips forward over one or more filemarks. 


The command format is 
FFILE INPUT Lyn] 
OUTPUT [, ALL] 


INPUT specifies that the command applies to the 
input file 


where: 


OUTPUT specifies that the command applies to the 
output file 


n 1s a decimal integer specifying the number 
of filemarks to be skipped. The default is l. 


ALL is a keyword, which, when entered, specifies 
that all filemarks are to be skipped until 
end-of-volume is reached. 


On contiguous files and magnetic tapes, NFILE skips forward 
over filemarks.. When the command has been executed, magnetic 
tapes are positioned just after the last filemark skipped, 
while contiguous files are positioned at the record after the 
last filemark skipped. When the file specified is an 

indexed file, the file is positioned at the end of the file. 


The INPUT or OUTPUT file must support filemarks. In order 
for pseudo filemarks to be recognized in contiguous files, 
the PSFM option must be set. See the OPTIONS command for 

information on the PSFM option. 


This command cannot be applied to a labelled magnetic tape. 


When an integer, n, is entered, command execution ends when 
n filemarks are skipped or when end-of-medium is encountered. 


When the keyword ALL is entered, command execution ends when 
end-of-volume or two consecutive filemarks are read. 


Examples: 
FFILE INPUT skip one filemark on the 
input device. 
FRILE: OUTPUT,3 skip three filemarks on 
the output device. 
FFILE OUTPUT,ALL skip to end of volume on 


the output device. 
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4.4.10 FILES Command 

The FILES command produces a display of current input, output, 
list, command and log files, including various file attributs 
established by the INPUT and OUTPUT commands. The command 
format is: 


FILES 


The display has the following form: 


INPUT seta fname Lrecl record no pad 
VARIABLE /blk 
VOLID: XXXXXX XXXXXK XXXKXX XXXXXX XXXXXX 
OUTPUT fd fname lrecl record no pad expiry 
VARIABLE /olk ~date 
VOLID: XXXXXX XXXXXKX XXXXKXK XXXXXX <xXcxe Ks 
LIST fd 


COMMAND fd 


LOG eG 


Where: 


me is the file descriptor of the 
indicated file 


fname - ds the filename on labelled 
tapes; omitted if not labelled 
tape 


VARIABLE is output if variable length 
record processing is in effect. 


lrecl/blk is the record length and block- 
ing factor; blk is omitted for 
devices other than tapes. 


record no. is the current record number 
last processed in the file; a zero 
value indicates positioning in 
front of a file mark on a contig- 
uous file. 


expiry-date is expiration date for output 
labelled tapes 


XXXXXX the volume ids for labelled tapes. 
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It is not possible to determine the correct record position 
as a result of a FFILE command issued for contiguous files, 
or FFILE, BFILE, FRECORD, or BRECORD for magnetic tapes. 
The record position in the file is output as a relative 
position. 


The labelled tape information is omitted if it is not 
known or is blank. 


Examples: 
FILES 


Typical output produced on the log device is: 


INPOT MAGI: 80/5 1 
OUTPUT M300:A.CAL/P 80 Z: 
LIST CON: 
COMMAND CON: 
LOG CON : 


The input tape is unlabelled. 
character would be displayed. 


If it were labelled, a pad 


Example: Labelled tape on output: 
INPUT M300: A.DATE/P 120 L 
OUTPUT MAGI: FNAME .L 120/5 1 20 80001 
VOLID 100000 100001 100002 100003 
List CON: 
COMMAND CON: 
LOG CON 


The output tape is labelled, blocked five 120 byte records to 
a block, positioned at record 1, has a pad character of X'20', 
an expiry date of Jan. 1, 1980, and volume identifiers of 


100000, 100001, 


100002, and 100003. 


INPUT MAG4: 80/2 ad 
LIST PRs 
LOG CON 
COMMAND CON 


The input tape is blocked two 80 byte records per block. The 
current record position is undefined. 
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INPUT M301: FILE.CON/P 256 -2 
LIST PR: 

LOG CON: 

COMMAND CON: 


The input file is contiguous and due to a previous file pos- 
itioning command, the file is positioned two records in front 
of a filemark. 
Example: 

FF IN (End-of-medium message is output) 

BR IN,2 

FILES 

The record number output is -2. 


Output file is a magnetic tape. 


FF OUT 
PILES 


Record no. EOF 


BR OUT 
PILES 


Since one magnetic tape record may contain any number of phy- 
Sical records, an asterisk is output for record position. 
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4.4.11 FRECORD Command 


This command skips forward over one or more records. 


The command format is 


FRECORD [INPUT |[,n] 
OUTPUT 


Where: 
INPUT specifies that the command applies to 
the current input file. 
OUTPUT specifies that the command applies to 
the current output file. 
n is a decimal integer specifying the 


number of records to be skipped. The 
default is 1. When the file is to be 
positioned is a blocked unlabelled 
magnetic tape, n signifies the number 
of blocks to be skipped beginning at 
the current position of the tape. 


FRECORD skips records until n records are skipped or until 
a filemark of end-of-medium is reached, whichever comes first. 


This command cannot be applied to a labelled magnetic tape. 


Examples: 
FRECORD INPUT Skip one record forward on the 
input device. 
FRECORD OUTPUT, 20 Skip 20 records forward on the 


output device. 
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4.4.12 INPUT Command 


This command allows you to specify information about the input 
file. Its use is required when labelled or blocked unlabelled 
tapes, or disc files with non-zero keys, or records of variable 
length are to be copied, verified, or displayed. Its use is 
also necessary when a file or device is to be positioned (using 
the positioning commands, FRECORD, FFILE, etc.) if the file to 
be positioned is not the current input file. 


The command format is: 


INPUT * \(,lrecl[/blk]] [, VARIABLE] [, KEYS=xxxx] [, LABEL] 
fd 


(, FNAME=fn] [, VOLID=id] [, PAD=pp] 


where: 
fd is the file descriptor of the input file. 

This file becomes the current input file. 

If fd is a disc file, it must already exist. 
= is used to designate the current IApUS: Fie. 
ireci is the record length for tapes. The default 

is 80, bytes. 
blk is the blocking factor for tapes. The de- 


fault 15-1 record per block. The product. of 
lrecl and blk must not exceed 219-1 or 32760 
for labelled tapes. 


VARIABLE Specifies variable length record processing. 
Default is fixed record length. Can only be 
used with unlabelled, unblocked magnetic tape, 
paper tape, and interactive devices. Ilrecl 
should specify maximum expected record length. 


XXXX are the write-read keys, two hexadecimal 
bytes. The default is 0000. 


LABEL must be entered if the tape is labelled. If 
it is not, FNAME, PAD, and VOLID are ignored. 


in is a 1 to 17 character file identifier fora 


labelled tape. If not entered, the file iden- 
tifler 1s ignored. 
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id 


PP 


Examples: 


is a list of volume ids. Each id may be 
up to 6 alphanumeric characters. If more 
than one id is entered, the list of volume 
ids must be enclosed in parentheses. If 
not entered, volume ids are not validated. 
If entered, input tapes must be mounted in 
the order specified by the volume ids. 


is a two digit hexadecimal pad character. 
The default is X'FF'. Records of labelled 
tapes which consist of all pad characters 
are ignored. 


INPUT A.CAL,KEYS=AA03 Make A.CAL the new input file. 


Set AAQ3 as the write-read keys. 


INPUT MAGI1:, 80/5 The tape on MAG1: becomes the 


current input file. The record 
length is 80 and the blocking 
factor 1S 5. 


INPUT *; 120 The current input file is to be 


read with a record length of 120 
and a blocking factor of l. 


IN MAG2:,LABEL, The tape on MAG2: is labelled. 
FNAME=ALPHA, Its file identifier is ALPHA; two 
VOLID= (100000, tape volumes are to be mounted for 

100001) input; the volume ids should be 


mounted in the order 100000, 100001. 
The record length and block size 
are taken from the label. 


INPUT MAGI: ,LABEL, The labelled tape on MAGI]: must 


80/10, VOL=999888 have volume id 999888; it must 


have 80 byte records blocked 10 
records per block or the tape 
will not be read. The file iden- 
tifier in the label will be ignored. 


INPUT PTRP:,80, The paper tape in the paper tape 
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VARIABLE reader contains records of vari- 


able length. The maximum expect- 
ed record length is 80 bytes. 


4.4.13 LIST Command 
This command changes the list device. The command format is: 
LIst fd 


where: 


=o is the file descriptor of the new 
list device. 


7 


The list and log devices may be the same. In this case, the 
list and log output are intermixed since the same logical 
unit is used for both. 

Example: 


“LIS? PRL: use PRl: as the list device. 
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4.4.14 LOG Command 
This command changes the log device. The command format is: 
LOG fd 

where: 

ta is the file descriptor of the new log device. 
The log and list devices may be the same. In this case, the 
log and list output are intermixed since the same logical 
unit is used for both. 
Example: 


LOG PRl: use PR1l: as the log device. 
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4.4.15 NOLOG Command 


This command suspends logging until a LOG command is entered. 
The command format is: 


NOLOG 
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4.4.16 OPTIONS Command 


This command sets or displays options which are in effect dur- 
ing the execution of the program. The command format is: 


OPTIONS . 


[, FILL=xx] 


where: 


NOFM 
EM 


NOPSFM 
PSFM 


BINARY 
ASCII 


FILL=xx 


TERMINATOR 
=XXXXK 


CONTINUE 
NOCONT 
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NOFM NOPSFM BINARY ] 
fear “4 PSFM] " ,ASCITI] 


, TERMINATOR=xxxx , CONTINUE ] 
- NOTE RM] LNT 


These options control the writing of 
filemarks and positioning of the out- 
put file after a copy to a magnetic 
tape or contiguous file. See below 
for details. 


These options control recognition of the 
pseudo-filemark (X'1313') associated with 
contiguous files. If the NOPSFM option is 
set, pseudo-filemarks are ignored when 
reading a contiguous file or when a WFILE, 
BFILE, FRECORD, or BRECORD command is issued 
for a contiguous file. 


These options control the I/O mode. 


This option sets the fill character for 
Output records which are longer than in- 
put records. The fill character is speci- 
fied as xx, two hexadecimal digits. 


This option sets a sequence of characters 

to be recognized as an end-of-file indica- 
tor. xXxXxXx consists of one to four ASCII 
characters with no imbedded blanks. For an 
input record to be recognized as end-of-file, 
the program must be in ASCII mode, the first 
characters of the record must match the 
terminator sequence and the rest of the 
record must consist of blanks. NOTERM sup- 
presses recognition of the indicator as set 
by TERMINATOR. 


These options control 0OS/32 COPY actions 
following a mismatch during a VERIFY 
operation. When CONTINUE is in effect, 
OS/32 COPY continues verifying the files. 
When NOCONT is in effect, verifying ends 
if a mismatch occurs. 


The default values are: 


FM FPILL=20 
PSFM TERMINATOR=/* 
ASCIT NOCONT 


The default values are in effect when O0S/32 COPY begins execu- 
tion. Each time an OPTIONS command is entered, only those 


options that are entered are changed. The others remain as 
they were. 


If OPTIONS is entered with no parameters, the current options 
are displayed. 


When an end-of-file is encountered in the input file or an end- 
of-medium if the input file is a contiguous file, the following 
occurs: if NOFM is set and the output file is contiguous, no 
filemark is written; if NOFM is set and the output file is un- 
labelled magnetic tape, two filemarks are written and the tape 
lis backspaced two filemarks. 


If FM is set and the output file is contiguous, a filemark is 
written. Failure to write this filemark because of end-of- 
medium status is not considered to be an error. If the output 
file:is unlabelled magnetic tape, two filemarks are written 
and the tape is backspaced one filemark. 


As a result of this positioning, the next COPY to the current 
output device is separated from the previous data by a file- 

mark if FM is set, and is not separated if NOFM is set. Fur- 
thermore, the last file copied to an unlabelled magnetic tape 
is followed by two filemarks indicating end-of-volume. 


The FM/NOFM option does not apply to labelled tapes. 


Examples: 


OPTIONS Obtain a list of the current 
options. 


OPTIONS NOTERM, ASCII Set a mode to ASCII; no termin- 
ator sequence is to be recognized. 


OPTIONS CONTINUE Continue verifying an entire file 
even when mismatches occur. 


OPT TERM=ENDF,FILL=00 ENDF is the terminator string, 
larger output records are to be 
filled with zeros. 


OPT NOFM Suppress filemarks on output. 
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4.4.17 OUTPUT Command 


This command allows you to specify information about the out- 
put file. Its use is required when labelled or blocked un- 
labelled tapes, disc files with non-zero keys or variable 
length records are to be copied, verified, or displayed. Its 
use is also necessary when a file or device is to be positioned 
(using the positioning command: FRECORD, FFILE, etc.) if the 
file to be positioned is not the current output file. 


The command format is: 


oureur {| [, lrecl[/b1k]] [, VARIABLE] [, KEYS=xxxx] [, LABEL] 
fd 


[, FNAME=fn] [, VOLID=id] [, PAD=pp] [, EXPIRY=yyddd] 


where: 

fd is the file descriptor of the output file which 
becomes the current output file. If fdisa 
disc file, it must already exist. 

- is used to designate the current output file. 

lrecl is the logical record length for tapes. The 
default is the record length of the input file. 

blk is the blocking factor for tapes. Default is 


1 record per block or that of the input tape. 
ThE product of lrecl and blk must not exceed 
2-°P-1, or 32760 for labelled tapes. 


VARIABLE Specifies variable length record processing. 
Default is fixed record length. Can only be 
used with unlabelled, unblocked magnetic tape, 
paper tape, and interactive devices. Jlrecl can 
specify a maximum output record length, other- 
wise the output record length is obtained from 
the input file. 


XXXX are the write-read keys, two hexadecimal bytes. 
The default is 0000. 


LABEL must be entered if the tape is labelled. If 
if is not, FNAME, PAD, EXPIRY and VOLID are 
ignored. 

fn is a l to 17 character file identifier (fdid) 


for a labelled tape. If not entered, the file 
identifier is written as blanks. 
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id is a list of volume ids. Each id is 6 alpha- 
numeric characters. I£ more than one id is 
entered, the list of volume ids must be enclosed 
in parentheses. If entered, tape volumes must 
be mounted in the order specified by the volume 
ids. 


pp is a digit two hexadecimal pad character. The 
default is X'FF'. This character pads the last 
block of a labelled tape if the number of records 
written does not fill the block. 


yyddd 1s the expiration date expressed as yyddd, where 
yy is the year (9-99) and ddd is the day within 
the year (1-365). If the EXPIRY parameter ls 
specified and the expiration date on the tape 
has not yet been reached, the output operation 
is not executed. If that expiration date has 
occurred, the value entered in the EXPIRY 
parameter is written on the tape label and 
the current date is written in the creation 
date field. 


The file descriptor or asterisk must be the first parameter 
entered. The other parameters may be entered in any order. 


Examples: 


OUTPUT A.CAL, KEYS=AA03 
Make A.CAL the new output file and set the 
write-read keys to X'AAQ3'. 


OUTPUT MAG1:,80/5 
The tape on MAGI: becomes the output file. The 
record length is 80 bytes and the blocking fac- 
tor 1s § records per block. 


OUTPUT. * 41.20 
The current output tape is to be written with 
a record length of 120 bytes and a blocking 
factor of l record per block. 


OUT MAG2: , LABEL, FNAME=BETA, 
VOLID= (100000,100001) 
The tape on MAG2: is labelled. Its file iden- 
tifier is BETA, and two tape volumes are to be 
mounted for output; the volume ids are mounted 
in the order 100000, 100001. The expiration 
date on the output tape is not checked. 
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OUTPUT MAG1:,LABEL, 80/10, VOL=999888 
The labelled tape on MAG1: must have volume 
id 999888; it will be written with 80 byte 
records blocked 10 records per block. No 
file identifier is written. The expiration 
date is not checked. 


QU MAG3: , LABEL, FNAME=AT0OZ,120/4, PAD=31 
EXPIRY=79365 
The labelled tape on MAG3: is to be written 
with file identifier ATOZ. It will have 120 
byte records, blocked 4 records per block. 
The pad character is hexadecimal 31. The new 
file expires on the 365th day of 1979. 


OUTPUT MAGILL: ,VARIABLE,132 
The tape on MAGI]: will contain records of 
variable length where the largest record is 
132 bytes long. 
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4.4.18 PAUSE Command 


This command causes 0OS/32 COPY to pause. The command format 
LS 


PAUSE 


MTM or OS commands may then be entered. A CONTINUE command 
causes OS/32 COPY processing to resume. 
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4.4.19 RENAME Command 


This command is used to change the name of a disc file. The 
command format is: 


RENAME oldfd,newfd 

where: 

oldfd is the old file name 

newfd is the new file name 
A file may only be renamed if its read and write protection 
keys are zero and it is not currently assigned to any Logical 
Unit of any task. If the file specified is the current input, 
log, or list file for OS/32 COPY, the corresponding Logical 


Unit is closed and the file is then renamed. 


The renamed file is not available for OS/32 COPY processing 
until it is explicitly selected again. 


Account numbers may not be specified as part of the file des- 
criptors. However, under MTM, the new file name can have a 
group file or system file indicator (/G or /S). 

Example: 


RENAME Al.CAL,A1.MAC Change the name of Al.CAL 
to AL.MAC 
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4.4.20 REWIND Command 


This command repositions a file or device at its beginning 
record if the device is rewindable. 


The command format is: 


REWIND / INPUT 
OUTPUT 


where: 


INPUT — specifies that the command applies to 
the current input file. 


OUTPUT specifies that the command applies to 
the current output file. 


If the file or device specified is not rewindable, an attri- 
bute warning occurs. 


Example: 
REWIND OUTPUT rewind the current 
OuLput. 21Le 
REW IN rewind the current 


1nput Lice 
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4.4.21 SEND STOP Command 


This command allows you to stop the execution of a COPY, 
DISPLAY, VERIFY, FRECORD, BRECORD, FFILE, or BFILE command. 


The command format is: 
SEND STOP 


The SEND STOP command is issued in response to an OS or MTM 
prompt. A prompt is obtained by depressing the BREAK key, 
possibly several times. When 0S/32 COPY is executing in the 
OS environment, it is necessary to select the OS/32 COPY 

task as the current task using the TASK command before issuing 
the SEND STOP command. 


Issuing the SEND STOP command causes OS/32 COPY to terminate 
the command which is currently being executed. After process- 
ing the SEND STOP command, OS/32 COPY is ready to accept the 
next command. In interactive mode, if the next command is 
CONTINUE, COPY resumes executing the previously terminated 
command. SEND STOP is ignored in batch mode. 


Examples: 
Under MTM: 
SEND STOP Stop execution of the current 


command. OS/32 COPY accepts 
the next command. 


Under OS/32MT: 


TASK COPY Select copy as the current 
task. 

SEND STOP Stop execution of the current 
command. 
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4.4.22 VERIFY Command 


The VERIFY command compares the current input file to the cur- 
rent output file record by record. 


If a pair of records is found which does not match, the two 
. records are displayed on the list device in the hexadecimal 
dump format produced by the DISPLAY command. The number of 
the first byte which does not match is also written. 

All or part of a Single file may be verified, or more than 
one file can be verified with a single VERIFY command. 


4.4.22.1 Command Format 


The command format is: 


VERIFY xl, * [, NRECS=m] 
fdl fd2/ | [,NFILES=n] 


where: 

fai is the file descriptor of the input file 

Fd2 is the file descriptor of the output file 

= indicates the current input or output file 

m. 1s a decimal number up to 6 digits specify- 
ing the number of records to be verified. 
The default is all records until end of file 
is read. 

n is a decimal number up to 6 digits in length 


specifying the numbers of files to be verified 
or the word ALL indicating that all files up 
to end-of-volume are to be verified. The 
default is 1 file. 


4.4.22.2 Effect of CONTINUE/NOCONT Option 


In case a mismatch occurs, the next action is determined by 
the CONTINUE/NOCONT option as previously set using the OPTIONS 
command or by default. The default is NOCONT. 


If NOCONT is in effect and the program is in interactive mode, 
a prompt is issued. You may continue verifying by entering 
CONTINUE, or you may enter a different command. If the program 
is in batch mode, a message is logged and the next command is 
read. 


A_9C¢ PQmuBnTAR DNA 2779 


If CONTINUE is set, verifying continues until all files or 
records specified have been compared, or until an end-of- 
file on one file is not matched by an end-of-file on the 
other. All records which do not match are written on the 
list device. 


4.4.22.3 NFILES and NRECS 


The parameter NRECS specifies the number of records which 
are to be verified. The default is the number of records 
in the file. Verifying stops if an end-of-file is en- 
countered on input. 


The parameter NFILES specifies the number of files which are 
to be verified. The default value is one. A file is term- 
inated by a filemark or by an ASCII terminator. See the 
OPTIONS command for information on ASCII terminators. Veri- 
fying terminates if an end-of-volume is encountered on input. 
End-of-volume is defined by two consecutive filemarks on 
magnetic tape, or end-of-medium on contiguous files. After 
each file has been verified, a message indicating the number 
of records which have been verified in that file is logged. 


If NFILES=ALL is entered, all files are verified until end-of- 
volume occurs on input. 


4.4.22.4 Verifying Records Having Different Record Lengths 


When the output record length exceeds the input record length, 
the output record is assumed to be padded with a fill character. 
The fill character can be set by the FILL option. See the 
OPTIONS command for information on the FILL option. The default 
is a hexadecimal 20 (ASCII blank). 


Data in both records is verified for the length of the input 
record. All remaining bytes in the output record must contain 
the fill character or a non-verify message is output. 


When the input record is larger than the output record, only 
the number of bytes contained in the output record are verified. 
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4.4.,22.5 Completion of VERIFY Command 


When the VERIFY command is successfully completed, a message is 
Logged: 


VERIFY COMPLETE - n FILES VERIFIED 
where nis the number of files verified. 


If one file or a portion of a file is verified (using NRECS), the 
message logged is: 


VERIPY COMPLETE = nm. ‘RECORD VERIFIED 


4.4.22.6 Examples 


VER A.CAL,CR: Verify a disc file with 
data read from cards. 

VERIFY Verify the current input 
and output files. 

VER *,*,NRECS=50 Verify 50 records of the 
current input and output 
files. 

VERIFY MAGI:,*,NFILES=2 Verify two files on MAGI: 


with two files on the cur- 
rent output file. 
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4.4.23 WFILE Command 


This command writes one or more filemarks on the current out- 
put or the current list file. 


The command format is 


WFILE } LIST , [,n] 
si 


OUTPU 
where: 

LIST specifies that the command applies to the 
current list file 

OUTPUT specifies that the command applies to the 
current output file 

n is a decimal integer specifying the number 
of filemarks to be written. The default 
is l. 


The output or list device on which the filemark is to be 
written must support the write filemark operation. See 
Appendix C for a table of device attributes. 


This command cannot be applied to a labelled magnetic tape 
and has no effect on indexed files. 


Examples: 
WFILES OUTPUT Write one filemark on the 
Output file. 
WF LI,2 Write two filemarks on the 
list file. 
WF OUT, 3 Write three filemarks on the 


Output device. 
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CHAPTER 5 
ERROR HANDLING AND MESSAGES 


5.1 ERROR HANDLING 


OS/32 COPY error processing depends on the nature of the 
error, and the mode of execution, interactive or batch. 
In either case, a message is written to the log device. 
If the command device is interactive, the error message 
is output to both the log device and the command device. 
In batch mode, if there is no log device or if the error 
applies to the log device, the message is logged to the 
system console. 


5.1.1 Interactive Mode 


In interactive mode, OS/32 COPY accepts another command 
following an error. 


The sole exception occurs when the error is an I/O error 
involving the command device. In this case, the message 
is logged to the console and the program terminates. 


In all other cases, OS/32 COPY prompts you for another 
command. It may be necessary to reenter the command if 
the error is a syntax, ALLOCATE, attribute, labelled tape, 
ASSIGN, or DELETE/RENAME error. If the error is an I/O 
error, you may be able to correct the condition causing 
the error, and then enter CONTINUE to cause the operation 
to continue. The only other command you may enter before 
CONTINUE is PAUSE. If you enter any other command, the 
previous command is considered to be terminated. 


5.1.2 Batch Mode 


- In batch mode a syntax error, ALLOCATE, ASSIGN, attribute 
labelled tape, or DELETE/RENAME error causes OS/32 COPY to 
terminate. An I/O error causes OS/32 COPY to pause. If 
OS/32 COPY is continued, it retries the I/O operation which 
caused the error to arise. 


5.1.3 Return Code 


If OS/32 COPY terminates normally due to an END command, it 
issues an end of task message with a return code of 0. If 

an error occurs when the START parameters are being processed, 
COPY terminates with an error code of 1. Any other errors 
causing abnormal termination result in an error code of 2. 
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5.2 MESSAGE SUMMARY 


*e* ALLOCATE EBRROR Ssiu FOR £¢d 
explanatory message 


where 


- ss is the status. 

- lu is the logical unit. 

- fd identifies the device or file 

- explanatory message is one of the following: 


DUPLICATE FILE NAME 

FILE DESCRIPTOR ERROR 
INSUFFICIENT DISC SPACE 
PRIVILEGE CANNOT BE GRANTED 
VOLUME NOT DIRECT ACCESS 
VOLUME ERROR 


Program Action: 


Terminates in batch mode; 
returns prompt in interactive mode. 


Required User or Operator Action: 


The user should correct the problem, then reissue 
the command if OS/32 COPY is in interactive mode. 


The program must be restarted if it was in batch 
mode. 
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*** ASSIGN ERROR sslu ON xxxx FOR fd 
explanatory message 


where 


- ss is the status. 
- lu is the logical unit. 
- XXXX 1S one of the following: 


COMMAND 
INPUT 
LIST 
LOG 
OUTPUT 


- fd identifies the device or file. 
- explanatory message is any of the following: 


FILE DESCRIPTOR ERROR 

FILE DOES NOT EXIST 
INSUFFICIENT DISC SPACE 
INSUFFICIENT SYSTEM SPACE 
MISMATCH ON READ-WRITE KEYS 
PRIVILEGE CANNOT BE GRANTED 
VOLUME ERROR 


Program Action: 


Terminates in batch mode, returns prompt in 
interactive mode. If an Assign Error is en- 
countered on the work file (LU 4) during a 
RENAME then 'ON xxxx' is not output with the 
message. 


Required User or Operator Action: 


The user should correct the problem, then 

reissue the command if 0OS/32 COPY is in interactive 
mode. The program must be restarted if it is 

in batch mode. 
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wee ATTRIBUTE: ERROR. ON xxxx POR fa 
explanatory message 


where 


~- XxXXX is one of the following: 


OUTPUT 


- fd identifies the device or file. 
- explanatory message is one of the following: 


DEVICE DOES NOT SUPPORT READ 
DEVICE DOES NOT SUPPORT WRITE 


Program Action: 


The file identified by fd is closed by the program. 
If the error is detected on the log device, logging 
is disabled and the program continues to execute 
without the logging feature. For attribute errors 
on devices other than the log device, the program 
terminates if it is in batch mode. It outputs a 
program prompt if it is in interactive mode. If the 
command device does not support ¥Yead the program 
terminates with End Of Task Code l. 


Required User or Operator Action: 


If the program was terminated while executing in 
batch mode it must be restarted. In interactive 
mode, the logging feature may be reenabled via 
the LOG command. In all other instances the com- 
mand can be reentered, specifying the correct 
device mnemonic. Alternatively, a new command 
may be entered, 
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**x* ATTRIBUTE WARNING ON xxxx FOR fd 
explanatory message 


where 
- XXXxX 1S one of the following: 


COMMAND 
INPUT 
LIST 
LOG 
OUTPUT 


- fd identifies the device or file. 
- explanatory message is one of the following: 


DEVICE DOES NOT SUPPORT BINARY 
DEVICE DOES NOT SUPPORT FORWARD RECORD 
DEVICE DOES NOT SUPPORT BACKSPACE RECORD 
DEVICE DOES NOT SUPPORT FORWARD FILE 
DEVICE DOES NOT SUPPORT BACKSPACE FILE 
DEVICE DOES NOT SUPPORT WRITE FILEMARK 
DEVICE DOES NOT SUPPORT REWIND 


Program Action: 


If the error is detected on the log device, logging 


is disabled and the program continues to execute 


without the logging feature. For attribute warnings 
on devices other than the log device, the program 
terminates and if it is in batch mode or outputs a 


program prompt if it is in interactive mode. 


Required User or Operator Action: 


If the program was terminated in batch mode, it has 

to be restarted after the device mnemonic has been 
corrected. In interactive mode, the logging feature 
may be reenabled via the LOG command. In all other 
instances the command can be reentered. Alternatively, 


a new command may be entered. 
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*** DELETE ERROR sslu FOR fd 
explanatory message 


where 


- ss is the status. 

lu is the logical unit. 

fd identifies the file. 

- explanatory message is one of the following: 


FILE CURRENTLY ASSIGNED 
FILE DOES NOT EXIST 
INSUFFICIENT SYSTEM SPACE 
PRIVILEGE CANNOT BE GRANTED 
VOLUME NOT DIRECT ACCESS 
VOLUME ERROR 


Program Action: 


Terminates in batch mode; returns prompt in 
interactive mode. 


Required User or Operator Action: 
The user should correct the problem, then reissue 
the command if the program is in interactive mode. 


The program must be restarted if it 1S in batch 
mode. 
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*** ERROR - fd ASSIGNED TO INPUT 

where 
- fd identifies the file 

Program Action: 
File specified for Output is also specified for Input 
in a Copy or Verify command. The present command is 
aborted. The program terminates in batch mode; it 
outputs a prompt in interactive mode. 

Required User or Operator Action: 
In interactive mode the user should reissue the com- 


mand with the appropriate output file descriptor. 
The program has to be restarted in batch mode. 
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*** INPUT FILE MUST BE ENTERED 
Program Action: 


Terminates if it is in batch mode; outputs a 
new prompt if it is in interactive mode. 


Required User or Operator Action: 
The user can correct the problem by specifying 
an input file in response to the program prompt. 


In batch mode, the program must be restarted with 
the correct command sequence. 
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**k* INVALID BLOCK/RECORD SIZE 


where 


- the value used for blk in the INPUT or 
OUTPUT command is zero, or the product 
of lrec and blk exceeds 216-1 or 32760 
for labelled tapes. 


Program Action: 


The program terminates if it is in batch 
mode. A new prompt is output in inter- 
active mode. 


Required User or Operation Action: 
Restart the program in batch mode with 
the correct parameters in interactive 


mode, re-enter the INPUT or OUTPUT 
command using the correct parameters. 
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*x** INSUFFICIENT MEMORY -nKB EXTRA REQUIRED 
where 


~ the value of n reflects the number of 
additional KB required by the program 


Program Action: 


The program terminates if it is in batch mode. If 
the program is in interactive mode, a new prompt 
is output. 


Required User or Operator Action: 


The program should be reloaded with a larger 
segment-~size-increment. 
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**x* T/O ERROR lussss ON xxxx FOR fd 
explanatory message 


where 


- lu is the logical unit. 
- ssss is the status halfword. 
- xxxx is one of the following: 


COMMAND 
INPUT 
LIST 
LOG 
OUTPUT 


- fd identifies the device or file. 
- explanatory message is any of the following: 


DEVICE UNASSIGNED 

DEVICE UNAVAILABLE 

END OF FILE 

END OF MEDIUM 

ILLEGAL FUNCTION 

PARITY OR RECOVERABLE ERROR 
UNRECOVERABLE ERROR 


Program Action: 


Pauses if error is on the command device. Pauses 
in batch mode; returns program prompt in inter- 
active mode. 


Required User or Operator Action: 


Appropriate corrective action should be taken if 
possible. If the program is in batch mode, or 
if error is on the command device, it may then 
be continued with the OS CONTINUE command. The 
OS CANCEL command should be entered if the error 
condition cannot be corrected. In interactive 
mode, a prompt will be issued. The OS/32 COPY 
command CONTINUE may be used to continue execu- 
tion of the previous command. If it is not 
possible to correct the error, a new command 

may be entered in response to the prompt. Any 
command other than PAUSE or CONTINUE will termi- 
nate the previous command. 
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exe 


LABELLED TAPE ERROR ON xXxxx 
explanatory message 


where 


- xxxx is either INPUT or OUTPUT. 
- the explanatory message is one of the following: 


BLOCK COUNT CHECK FAILS 

BLOCK/RECORD SIZE DIFFERS FROM HEADER LABEL 
EOM ON WRITE TAPE 

FILE IDENTIFIER DOES NOT MATCH 

FILE NOT OPENED 

FILE NOT YET EXPIRED 

INVALID BLOCK/RECORD SIZE 

INVALID COMMUN. AREA FORMAT 

INVALID LABEL FORMAT 

VOLUME IDENTIFIER DOES NOT MATCH 


Program Action: 


Terminates 1f it is in batch mode, 
returns a prompt if it is in interactive mode. 


Required User or Operator Action: 


After the error has been corrected, the program has 

to be restarted if it is in batch mode. The command 
can be reissued if the program is in interactive mode. 
Alternatively, a new command may be entered. 
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x*x* LIST FILE MUST BE ENTERED 
Program Action: 


Terminates if it is in batch mode and outputs a new 
prompt if it is in interactive mode. 


Required User or Operator Action: 
In interactive mode, the user can correct the problem 
by entering a LIST command with a list file descriptor. 


If the program is in batch mode, it must be restarted 
after the command has been corrected. 
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**x* OUTPUT FILE MUST BE ENTERED 


Program Action: 


Terminates if it is in batch mode: returns a prompt 
1f it is in interactive mode. 


Required User or Operator Action: 
The user can correct the problem by specifying an 
output file in response to the program prompt. In 


batch mode the program must be restarted with the 
correct command sequence. 
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***k RECORD LENGTH ERROR ON xxxx 
n BYTES READ, m BYTES EXPECTED 


where 


- XXXX 1s either INPUT or OUTPUT. 
- n is the number of bytes read. 
- mis the logical record length. 


Program Action: 


Terminates if it is in batch mode; 
returns a prompt if it is in interactive mode. 


Required User or Operator Action: 


The user should reissue the INPUT or OUTPUT 
command specifying the correct logical record 
length if fixed length record processing is 
desired, or the VARIABLE keyword if variable 
length records are expected. 
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*x** RENAME ERROR sslu FOR fd 
explanatory message 


where 


- sS is the status. 
- lu is the logical unit. 


fd identifies the file. 
explanatory message is one of the following: - 


FILE DESCRIPTOR ERROR 

FILE DOES NOT EXIST 

NAME ALREADY EXISTS 
PRIVILEGE CANNOT BE GRANTED 


Program Action: 


Terminates if it is in batch mode; returns a prompt 
if it is in interactive mode. 


Required 


The 
the 
The 


User or Operator Action: 


user should correct the problem, then reissue 
command if OS/32 COPY is in interactive mode. 
program must be restarted if it is in batch 


mode. 
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**k SYNTAX ERROR - xXXXX 
where 
- XXXxX 1S one Of the following: 


COMMAND LINE TOO LONG 

INVALID CHARACTER C' char ' 
INVALID CHARACTER X' hex.value ' 
INVALID DECIMAL PARAMETER yyyy 
INVALID FILE DESCRIPTOR yyyy 
INVALID FILL yyyy 

INVALID FNAME yyyy 

INVALID HEX PARAMETER yyyy 
INVALID JULIAN DATE yyyy 
INVALID KEY yyyy 

INVALID KEYWORD yyyy 

INVALID PAD yyyy 

INVALID TERMINATOR yyyy 
INVALID VOLID yyyy 

MISSING PARAMETERS (S) 

TOO MANY PARAMETERS 

UNBLANACED PARENTHESIS 


yyyy identifies the invalid parameter. 
char 1s an ASCII character. 


hex value is the hexadecimal value of a nonprintable 
character. 


Program Action: 


The program terminates if it is in batch mode; 
returns a prompt if it is in interactive mode. 


Required User or Operator Action: 
After the problem has been corrected, the program 
must be restarted if it is in batch mode. The 


command can be reissued if the program is in in- 
teractive mode. 
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END OF TASK CODES: 
Q - Normal Termination. 


L.-= Start. Option. Error. 
2- Errors in Batch Mode 
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APPENDIX A 


COMMAND SUMMARY 


ALLOCATE fd,CONTIGUOUS,fsize[,keys] 


ALLOCATE fd,INDEX[, [lrecl] [/[bsize] [/isize]][,keys]] 


INPUT 
BFILE [,n] 
OUTPUT 


INPUT 
BRECORD 
OUTPUT 


CONTINUE 


[, NRECS=m] 
COPY [, DELETE] 
[, NFILES=n] 


DELETE fdl,...] 


[4 NF ILES= m | 
DISPLAY 
[, NRECS=n ] 


END 
INPUT [,n] 
FFILE 
OUTPUT [ALL 
FILES 
INPUT 
FRECORD [,n] 
QUTPUT 
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INPUT [,lrecl[/b1k] ] [, KEYS=xxxx] [, LABEL] 


fd 


[, VARIABLE] [,FNAME=] [,VOLID=] 


List <4 
LOG fd 


NOLOG 


OPTIONS 


He] { | Ese] {| fscry 


[, PAD=] 


[TERMINATOR=xxxx| [CONTINUE] 
[,FILL=xx] ¢ : 
[NOTERM| [NOCONT| 
*® 
OUTPUT [, lrecl [/b1k]] [, KEYS=xxxx] [, LABEL] 
fd 
[VARIABLE] [, FNAME=] [, VOLID=] [,PAD=] [, EXPTRY=] 


PAUSE 


RENAME oldfd,newfd 


Input | 
REWIND 
OUTPUT 
SEND STOP 
. . [,NRECS=m] 
VERIFY ; 
fdl{/ \fd2; | (,NFILES=n] 
List 
WFILE [,n] 
QUTPUT 
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APPENDIX B 


TASK ESTABLISHMENT AND SIZE INFORMATION 


OS/32 COPY executes as a user task. The approximate size 
of the program, exclusive of buffer space provided when 
the task is loaded, is as follows: 


PURE segment 31 Kbytes 
IMPURE segment 5 Kbytes 


The following sequence can be used to establish OS/32 COPY 
as a task from an object version named COPY32.OBJ: 


*LOAD TET32 
*ASSIGN 5,CON: 
*ASSIGN 7,CON: 
*START 

ESTABLISH TASK 
INCLUDE COPY32 
EXPAND n 

BUILD TASK,COPY32 
MAP PR: 

END 


OS/32 COPY is segmented into pure and impure code for shared 
use with Operating Systems which support segmentation. If 
the program is to be established as a sharable task the 
ESTABLISH TASK command should be modified to ESTABLISH 

TASK, PURE. 


The argument n of the EXPAND command specifies the number of 
256-byte blocks to be reserved beyond the end of the task. 
The value of n can be calculated by: 


2 * recmax 


where 


recmax = largest expected record 
Or magnetic tape block size 


The size of workspace thus created may be overridden at 
load time. 
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APPENDIX C 


TABLE OF DEVICE CHARACTERISTICS 


CONT. INDEXED TTY/KP TTY/RP LOCAL HIGH SP LINE 
FILES FILES CRT PTRP PRINTER 
Read x x x x x x 
Write x xX X Xx* Xx X xX 
Binary Xx X X X 
Wait x x x Xx x xX Xx 
Random Xx x 
Uncond. xX Xx xX x x Xx x 
Proceed 
Image X x X Xx Xx x x 
Rewind Xx 
Backsp X Xx 
Record 
Forwsp x X 
Record 
Write X xX 
Filemark 
Backsp X Xx 
Filemark 
Inter- xX x 
active 
HaltI/O X X xX x X 
Device 0 (0) 2 (2) 16 (10) 81(51) 34(22) 80(50) 112 (70) 
Codes 17 (11) 82 (52) 36 (24) Lis fis) 
18 (12) 83 (53) 37 (25) 114 (72) 
Zi (15) 38 (26) 
22(16) 39 (27) 
23(17) 
* except for Carousel Reader 
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CARD CD RDR MV HEAD FLOPPY CASS. 9 TRK 


READER PUNCH DISc DISC TAPE MAGTAPE 

Read x xX xX x xX Xx 
Write Xx x x x x 
Binary x X x Xx X X 
Wait x X x X x X 
Random x Xx 
Uncond. x x x x x xX 
Proceed 
Image x Xx x Xx x 
Rewind x xX 
Backsp xX X 
Record 
Forwsp - & x 
Record 
Write . x x 
Filemark 
Forwsp x xX 
Filemark 
Backsp x Xx 
Filemark 
inter- 
active 
HaltI/o xX x x Xx 
Device 96 (60) b051(69) 49(31) 55 (37) 66 (42) 64 (40) 
Codes 97 (61) 50 (32) 65 (41) 

5433) 

52(34) 

53.035) 

54 (36) 
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APPENDIX D 


LABELLED TAPE FILE FORMAT SUMMARY 


Tape Layouts 
A diagramatic summary of the IBM standard format for files 


occupying one or more tape volumes is as follows (where 
each kind of label, e.g. VOL1, HDR1, is an 80 byte record): 


Single File Single File 
Single Volume Multiple Volumes 


Volume Label 


Header 
Label 


User Header 
Labels 


File Trailer 
Labels 


User Trailer 
Labels 


End of 
File 


*optional Labels 
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A diagrammatic representation of the ANSI standard format for 
files occupying one or more tape volumes is as follows: 


Single File Single File 
Single Volume 


Volume Label 


File Header 
Labels 


User Header 
Labels 


File Trailer 
Labels 


User Trailer 


* optional labels 
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For Labelled Files OS/32 COPY: 


l. Requires HDR2, EOF2 and EOV2 labels to be present on 
all input files, and always writes such labels to 
output files. 


2. Skips over (without processing) any number of User 
Labels on input files, and writes none to output files. 


3. Checks for only one file mark at the end of a tape 
volume terminated by one or more EOV labels, but always 
writes two. 


4. Checks, or writes to, only those fields within labels 
which are a common subset of the IBM and ANSI standards. 


5. Assumes all Identifiers within labels to include only 
characters 0-9,A-Z and -. 
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TAPE LABEL PROCESSING 


The fields processed within the various labels are as fol- 


lows: 


bs 


Volume Label 


Label Identifier 
(Bytes 1-4) 


Volume Identifier 
(Bytes 5-10) 


First Header Label 


Label Identifier 
(Bytes 1-4) 


File Identifier 
(Bytes 5-21) 


Creation Date 
(bytes 42-47) 
(taken from the 
system clock) 


Expiry Date , 
(Bytes 48-53) 


Second Header Label 


Label Identifier 
(Bytes 1-4) 


Record Format 
(Byte 5) 


Block Length 
(Bytes 6-10) 


Record Length 
(Bytes 11-15) 


Blocked Record Indicator 
(Byte 39) 
First Trailer Label 


Label Identifier 
(Bytes 1-4) 


File Identifier 
(Bytes 5-21) 


(80 bytes) 
(VOLL) 
(6 bytes) 
(alphanumeric) 
(80 bytes) 
(HDR1) 
(17 bytes) 
(left justified, 
space filled) 


(6 bytes) 
( yyddd) 


(6 bytes) 
( yyddd) 


(80 bytes) 


(HDR2) 
(F) 
(5 bytes, maximum 


decimal 32760) 


(5 bytes, maximum 
decimal 32760) 


(B if blocked 
records, 
blank otherwise) 


(80 bytes) 


(EOF 1) 
(EOV1L) 


(17 bytes) 
(as in HDR1) 
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- Block Count (6 bytes decimal) 
(Bytes 55-60) 


Bu Second Trailer Label 
- Label Identifier (EOF2) 
(Bytes 1-4) (EOV2) 


Extra labels are bypassed but not processed or checked. 
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APPENDIX E 


The Tape Labeller Program: 


To label unlabelled tapes on Perkin-Elmer 32-bit processors, a 
free-standing Tape Labeller Program is supplied, to be run 
under OS/32 or MTM. It is a non-overlaid program, supplied 

in task format. 


The program: 


1. Is supplied with a volume identifier and magnetic 
tape device name as start parameters; 


2. Checks that the volume identifier is a 6-character 
name; 
3. Rewinds the tape to be labelled, if necessary; 


4. Writes a Volume Label (VOL1); 


5. Writes a Header Label (HDR1) which is blank or zero 
other than the Label Identifier field; 


6. Writes a tape mark. 
The START command is of the form: 
A 
ST: 3° 'Volume-Identifier' , Device-Name 


E 


where A and E indicate ASCII and EBCDIC encoding respec- 
tively. 


For example: 
ST ,A'600445' ,MAGL: 
ST ,E'999402' ,MAG2: 


The device with the tape to be labelled is assigned to LU l 
automatically by the program. 


EOT return codes are: 
0 No error; 
ai EBrYror. 


The program's size is 2.0 Kb. 
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Error Messages generated by the Tape Labeller Program: 
l. Start Parameter Error Messages 
Message: 

DEVICE NAME IS TOO LONG 

or 


VOLUME IDENTIFIER IS TOO LONG 
or 


VOLUME IDENTIFIER CHARACTER IS NOT 0-9,A-2 OR - 
Or 


QUOTES OR COMMA MISSING 

A (ASCTE) ORE (EBCDIC) MISSING 
Send to: 

System Console or MTM Terminal. 
Program Action: 

Ends with End-of-Task code 1. 


Required User or Operator Action: 


Re-run with corrected start parameters. 


2. File Access Error Messages 
Message: 

*** ASSIGN ERROR 

explanatory message 

where the explanatory message is one of: 

‘DEVICE NAME NOT FOUND 

DEVICE DOES NOT SUPPORT WRITE 

DEVICE IS UNAVAILABLE 

DEVICE IS NOT A TAPE DRIVE 


Send to: 


System Console or MTM Terminal. 
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Program Action: 
Ends with End-of-Task code l. 
Required User or Operator Action: 


Correct and re-run. 


3. I/O Error Messages. 
Message: 
*x** T/O ERROR 
explanatory message 
where the explanatory message is one of: 
DEVICE IS UNAVAILABLE 
END OF MEDIUM ENCOUNTERED 
PARITY ERROR 
UNRECOVERABLE WRITE ERROR 
Send to: 
System Console or MTM Terminal. 
Program Action: 
Ends with End-of-Task code l. 
Required User or Operator Action: 


Correct and rerun. 
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INDEX 


ALLOCATE Command, 4-5 
ALLOCATE ERROR, 5-2 
ASCII/BINARY Mode, 3-32 
ASSIGN ERROR, 5-3 
ATTRIBUTE ERROR, 5-3 
ATTRIBUTE WARNING, 5-5 
Automatic Allocation of Output Files, 3-22 
Backward and Forward File, 3-30 
Batch Mode, 2-5, 5-lL 
Batch Operations, 3-36 
BFILE Command, 4-6 
BRECORD Command, 4-7 
Command Device: Command-fdl, 2-3 
Command Format, 4-9, 4-36 
Command Parameters, 4-4 
Command Summary, A-l 
Command Syntax, 4-3 
Commands: ALLOCATE, 4-5 
BFILE, 4-6 
BRECORD, 4-7 
CONTINUE, 4-8 
COPY, 4-13 
DELETE, 4-14 
DISPLAY, 4-15 
END, 4-16 
FFILE, 4-17 
FILES, 3-35, 4-18 
FRECORD, 4-21 
INPUT, 4-22 
LIST, 3-35, 4-24 
LOG, 3-35, 4-25 
NOLOG, 3-26, 3-35, 4-26 
OPTIONS, 3-32, 4-27 
OUTPUT, 4-29 
PAUSE, 4-32 
RENAME, 4-33 
REWIND, 3-31, 4-34 
SEND STOP, 4-35 
START, 2-4 
VERIFY, 4-36, 4-38 
WFILE, 4-39 
Commands, OS/32 COPY, 4-5 
Command Parameters, 4-4 
Communicating with OS/32 COPY, 2-5 
Completion of VERIFY Command, 4-38 
Continuation of Commands, 4-3 
CONTINUE Command, 4-8 
CONTINUE/NOCONTINUE Option, 3-27, 3-34, 4-36 
COPY Command, 4-13 
COPY Operations, Fundamental, 3-2 


COPY Operations, More Elaborate, 
Copying a Disc File to Another File or Device, 
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INDEX (cont'd) 


Copying Disc Files with Protection Keys, 3-32 
Copying Labelled Magnetic Tape, 3-5, 3-6 

Copying Multiple Files, Single Command, 3-19 
Copying Part of a File, 3-20 

Copying Records with Different Record Lengths, 4-12 
Copying To or From Other Devices, 3-ll 

Copying Unlabelled Magnetic Tapes, 3-3, 3-4 

Copying Variable Length Records, 3-24 

"Current" File Maintenance, 4-1 


Default Allocation and Record Lengths, 4-9 
Default Assignments of List and Log Devices, 3-36 
Default Values, 3-4 

DELETE Command, 4-14 

DELETE ERROR, 5-7 

Determination of FILE Attributes, 4-1 

Device Characteristics Table, C-l 

Disc File, Copying to Another File or Device, 3-2 
Disc Files with Protection Keys, Copying, 3-23 
DISPLAY Command, 4-15 

Displaying Files, 3-28 


Effect of CONTINUE/ NOCONT Option, 4-36 

END Command, 4-16 - 

End-of-File, 3-13 

End-of-Medium, 3-13, 3-16, 4-11 

END OF “TASK CODES, 5-18 

End-of-Volume, 3-13, 3-14, 3-36 

ERROR, 5-7 

Error and End-of-Volume Handling, 3-36, 5-l 
Existing Output Disc Files, 4-10 


FFILE Command, 4-17 

File Attributes, Determination of, 4-1 
File Descriptor Parameter, Implicit Specification of, 4-4 
File Handling, 4-1 

File Maintenance, "Current", 4-1 

File Mark Recognition, 3-32 

File Marks, Writing, 3-31 

File Positioning, 3-29 

FILES Command, 4-18, 4-35 

Files, Displaying, 3-28 

Fill Character Designation, 3-34 
Forward File and Backward File, 3-30 
FRECORD Command, 4-21 

Fundamental Copy Operations, 3-2 


Getting Started, 2-1 
Guide to OS/32 COPY Features, 3-1 


INPUT Command, 4-22 
INPUT FILE (error), 5-8 
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Input and Output Files, Implicit Specification of, 3-17 


Interactive Mode, 2-5, 5-1 

INVALID BLOCK/RECORD SIZE (error), 5-9 
INSUFFICIENT MEMORY (error), 5-10 

I/O ERROR, 5-ll 


Labelled Magnetic Tape, 4-2 

LABELLED TAPE ERROR, 5-12 

Labelled Tape File Format Summary, D-1l 
Labelled Tapes, Output, 3-9 

List and Log Device, Default Assignments of, 3-36 
LIST Command, 3-35 

List Device: LIST=fd3, 2-4 

LIST FILE (error), 5-13 

Loading OS/32 COPY, 2-1 

LOG Command, 3-35, 4-25 

Log Device: LOG=fd2, 2-4 


Magnetic Tapes, Labelled, 3-4, 3-5, 3-6, 4-2 
Message Summary, 5-2 

Mode of Program Operation, 2-5 

Multiple Files with Single Command, 3-19 


NFILES and NRECS, 4-10, 4-37 
NOLOG Command, 3-26, 4-26 


OPTIONS Command, 3-32, 4-27 

OPTIONS, LIST, NOLOG and FILES Commands, 3-32 
OS/32 COPY Commands, 4-5 

OS/32 COPY, Communicating With, 2-5 

OS/32 COPY, General Description of, 1-1 

OS/32 COPY, Guide to Features, 3-l 

OS/32 COPY, Loading, 2-1 

OS/32 COPY Overview, 3-1 

O0S/32 COPY Reference Guide, 4-1 

OS/32 COPY, Starting, 2-3 

OS/32 COPY, Stopping, 2-6 

OUTPUT Command, 4-29 

Output Disc Files, Existing, 4-10 

OUTPUT FILE (error), 5-14 

Output Files, Automatic Allocation of, 3-22 
Output Files (Non-empty) in COPY Command, 3-36 
OUTPUT LABELLED TAPES, 3-9 

Overview of OS/32 COPY Commands, 3-1 


PAUSE Command, 4-32 

Pausing the Program, 2-6 

Program Operations, Mode of, 2-5 
Program, Terminating, 2-6 

Pseudo Filemark Recognition, 3-33 
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RECORD LENGTH ERROR, 5-15 
Record Positioning, 3-3l 
Reference Guide, 0OS/32, 4-1 
RENAME Command, 4-33 
RENAME ERROR, 5-16 

Return Code, 5-1 

REWIND Command, 3-31, 4-34 
SEND STOP Command, 4-35 
SEND STOP Processing, 3-36 
START Examples, 2-4 
Starting OS/32 COPY, 2-3 
Stopping OS/32 COPY, 2-3 
SYNTAX ERROR, 5-17 


Table of Device Characteristics, C-l 

Tape Labeller Program, E-l 

Task Establishment and Size Information, B-l 
Terminating the Program, 2-6 

Terminator Sequence, 3-33 

Terminator, User Specified, 3-12 


Unlabelled Magnetic Tape, 3-3, 3-4 
Use of CONTINUE/NOCONT Option, 3-27, 3-34 
User Specified Terminator, 3-12 


Variable Length Records, Copying, 3-24 

Verification Following COPY, 3-25 

VERIFY Command, 4-36 

VERIFY Command, Completion of, 4-38 

Verifying, 3-25 

Verifying Records Having Different Record Lengths, 4-37 
Verifying Without a COPY Command, 3-36 


WFILE Command, 4-39 
Writing Filemarks, 3-3l 
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